Stops

The stops endpoint provides the latest information on all bus and tram stops served by Transport for Edinburgh.

Update frequency

Once a day

Resource

GET /v1/stops

Authorisation

API Authentication Token

Response

Status-Code: 200 OK

JSON

{
    "last_updated": 1419853198,
    "stops": [
        {
            "stop_id": 36235736,
            "atco_code": "6200242500",
            "name": "Fishmarket Square",
            "identifier": null,
            "locality": "Newhaven",
            "orientation": 271,
            "direction": "W",
            "latitude": 55.98071,
            "longitude": -3.19447,
           	"service_type": "bus",
            "destinations": [
                "Hyvots Bank", 
                "Silverknowes"
            ],
            "services": [
                "11",
                "16",
                "N16"
            ],
          	"atco_latitude": 55.98073,
          	"atco_longitude": -3.19446
        }
        ...
    ]
}

Name	Type	Description
last_updated	int	The time since this endpoint was last updated
stop_id	int	The stop's unique SMS code - this is used by the Open Data API as the canonical ID for each stop
atco_code	string	The stop's NaPTAN code - used with many journey planning systems
name	string	The name shown on the stop flag
identifier	string	A two-letter code used by some stops in high-density areas (such as 'PQ', 'PR' etc) where stops may be close to each other
locality	string	The town, village or locality the stop is situated in
orientation	int	The direction of the stop in degrees (0-360)
direction	string	The direction of the stop in compass points (NE, SE etc)
latitude	float	The latitude of the stop
longitude	float	The longitude of the stop
service_type	string	The type of stop (will be either tram or bus)
destinations	Array(string)	A list of destinations that this stop serves
services	Array(string)	A list of services that this stop serves
atco_latitude	float	Latitude of the stop within the NaPTAN database (see note below)
atco_longitude	float	Longitude of the stop within the NaPTAN database (see note below)

Note on stop co-ordinates
NaPTAN is the UK-wide database that provides stop locations. All of the journey planning systems such as Google Maps use this system. Unfortunately, you might find that NaPTAN's co-ordinates are several meters out from the actual stop location. We provide two extra fields - atco_latitude and atco_longitude - that you can use to match a stop given by Google Maps to our own database.