Method name

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"
  }
}