GET closestShowing

Description

Returns the nearest cinema showing the film, regardless of time and date, for a given film and location.

Example request

closestShowing/?film_id=123456

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 Latitude and LongitudeMandatory

Sent Arguments

Sent argumentDescriptionData typeOptional / Mandatory
film_idThe MovieGlu numeric internal film IDIntegerMandatory
nLimit the number of returned results. Default is 5, System max is 20.IntegerOptional

Caching

The returned data should not be cached.

Returned data

Returned KeyDescription
film_idThe MovieGlu numeric internal film ID
film_nameThe film name
cinemasArray – Cinemas showing requested film in distance order
cinema_idThe MovieGlu numeric internal cinema ID
cinema_nameThe cinema name
addressCinema address
cityCinema city
countyCinema county
postcodeZip code or post code
latCinema latitude
lngCinema longitude
distanceDistance from user’s geolocation (if provided in header)
logo_urlLocation of logo image for cinema (generally available for chains 4 or more cinemas)
dateDate of closest showing
timeTime of closest showing

Example response


{
  "film_id": 188115,
  "film_name": "Fantastic Beasts and Where to Find Them",
  "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",
      "date": "2017-02-08",
      "time": "17:30"
    },
    {
      "cinema_id": 29287,
      "cinema_name": "Vue Cinemas - Westfield Stratford City",
      "address": "2 Stratford Place",
      "city": "London",
      "county": "Greater London",
      "postcode": "E20 1EJ",
      "lat": 51.542839,
      "lng": -0.00762,
      "distance": 5.7239831868778,
      "logo_url": "https://d2z9fe5yu2p0av.cloudfront.net/chainlogos/uk/UK-712-sq.jpg",
      "date": "2017-02-08",
      "time": "21:50"
    }
  ],
  "count": 2,
  "status": {
    "state": "OK",
    "code": 1,
    "method": "closestShowing",
    "message": null,
    "request_method": "GET",
    "version": "MGv101"
  }
}