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 headerDescriptionData typeOptional / Mandatory
geolocationGeolocation 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 LongitudeMandatory

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
nLimit the number of returned results. Default is 10, System max is 25.IntegerOptional

Caching

The returned data should not be cached.

Returned data

Returned KeyDescription
cinemasArray – List of cinemas nearby, based on user’s geolocation
cinema_idThe MovieGlu numeric internal cinema ID
cinema_nameThe cinema name
addressCinema address line 1
address2Cinema address line 2 (where available)
cityCinema city
countyCinema county
postcodeZip code or post code
latCinema latitude
lngCinema longitude
distanceDistance in MILES from user’s geolocation (if provided in header)
logo_urlLocation 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"
  }
}