Method name
- Quick start guide
- Troubleshooting
- Headers and Responses
- Sample code
- GET filmsNowShowing
- GET filmsComingSoon
- GET filmLiveSearch
- GET cinemaLiveSearch
- GET filmDetails
- GET cinemaDetails
- GET cinemasNearby
- GET cinemaShowTimes
- GET filmShowTimes
- GET closestShowing
- GET purchaseConfirmation
- GET images
- GET trailers
GET cinemasNearby
Description
Return a list of the nearest N cinemas based on a specific location.
Important Notes
The list of cinemas returned may change from day to day, because only those cinemas with showtimes in the next 10 days will be returned.
Example request
cinemasNearby/?n=5
Required headers
Sent header | Description | Data type | Optional / Mandatory |
---|---|---|---|
geolocation | Geolocation of end user, used to calculate distance of cinema from user. Format must be lat;lon for example 51.510391;-0.13013.
Important – the geolocation must be inside the territory which you are using – for example, if you are using a French licence, then the geolocation must be inside France. If the gelocation is outside the territory, a 204 status is returned. | Latitude and Longitude | Mandatory |
Sent Arguments
Sent argument | Description | Data type | Optional / Mandatory |
---|---|---|---|
n | Limit the number of returned results. Default is 10, System max is 25. | Integer | Optional |
Caching
The returned data should not be cached.
Returned data
Returned Key | Description |
---|---|
cinemas | Array – List of cinemas nearby, based on user’s geolocation |
cinema_id | The MovieGlu numeric internal cinema ID |
cinema_name | The cinema name |
address | Cinema address line 1 |
address2 | Cinema address line 2 (where available) |
city | Cinema city |
county | Cinema county |
postcode | Zip code or post code |
lat | Cinema latitude |
lng | Cinema longitude |
distance | Distance in MILES from user’s geolocation (if provided in header) |
logo_url | Location of logo image for cinema (generally available for chains 4 or more cinemas, not all countries) |
Example response
{
"cinemas": [
{
"cinema_id": 8795,
"cinema_name": "ODEON Leicester Square",
"address": "24-26 Leicester Square",
"city": "London",
"county": "Greater London",
"postcode": "WC2H 7JY",
"lat": 51.510479,
"lng": -0.12952,
"distance": 0.026927763381187,
"logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-614-sq.jpg"
},
{
"cinema_id": 8893,
"cinema_name": "Cineworld Leicester Square",
"address": "Leicester Square",
"city": "London",
"county": "Greater London",
"postcode": "WC2H 7NA",
"lat": 51.51078,
"lng": -0.1305,
"distance": 0.031255415281335,
"logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-868-sq.jpg"
},
{
"cinema_id": 8923,
"cinema_name": "Vue Cinemas - West End",
"address": "3 Cranbourn Street",
"city": "London",
"county": "Greater London",
"postcode": "WC2H 7AL",
"lat": 51.511181,
"lng": -0.12934,
"distance": 0.064288623403495,
"logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-712-sq.jpg"
},
{
"cinema_id": 9545,
"cinema_name": "Prince Charles Cinema",
"address": "7 Leicester Place",
"city": "London",
"county": "Greater London",
"postcode": "WC2H 7BY",
"lat": 51.511421,
"lng": -0.13034,
"distance": 0.071755108431306,
"logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-0-sq.jpg"
},
{
"cinema_id": 8797,
"cinema_name": "ODEON Panton Street",
"address": "11/18 Panton Street",
"city": "London",
"county": "Greater London",
"postcode": "SW1Y 4DP",
"lat": 51.509609,
"lng": -0.13136,
"distance": 0.075604237964265,
"logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-614-sq.jpg"
}
],
"status": {
"count": 5,
"state": "OK",
"method": "cinemasNearby",
"message": null,
"request_method": "GET",
"version": "MGv200",
"territory": "UK",
"device_datetime_sent": "2018-09-14T14:06:21.449Z",
"device_datetime_used": "2018-09-14 14:06:21"
}
}