SL Nearby stops v2.0 (Närliggande hållplatser 2)
Beskrivning
Med detta API kan du få information om närliggande hållplatser till en försedd plats baserad på lat och long.
URL
api.sl.se/api2/nearbystopsv2.<FORMAT>?key=<DIN NYCKEL>&originCoordLat=<LAT>&originCoordLong=<LONG>&maxNo=<MAX ANTAL SVAR>&r=<RADIUS I METER>
API-nyckelnivåer
| Nivå | Max anrop/minut | Max anrop/månad |
|---|---|---|
| Brons | 30 | 10 000 |
| Silver | 60 | 500 000 |
| Guld | Efter behov |
Format
Json eller xml enligt ändelse till serviceanropet.
Parametrar
Namn | Datatyp | Tvingande | Beskrivning |
Key | String | Ja | Din API nyckel. |
originCoordLat | String | Ja | Lat |
originCoordLong | String | Ja | Long |
maxNo | Integer | Nej | Maximalt antal resultat som önskas. 9 är default, max är 1000. |
r | Integer | Nej | Radius runt försedd koordinat som närliggande hållplatser skall hämtas ut för. 1000 är default, max är 2000. |
products | Nej | Produktfilter, Kombinationsvärde av önskade trafikslag om inte alla ska användas vid utsökning av resor. Bitmask enligt följande: Värdes anges som heltalsvärdet av den kombinerade bitmasken, ex Buss och båt, 8+64 = 72 | |
type | Nej | Typfilter för platser, |
Resultat
Svarsstruktur
Namn | Datatyp | Beskrivning |
serverVersion | String | Versionsinformation. |
dialectVersion | String | Versionsinformation. |
requestId | Long | En id som identifierar anropen. |
stopLocationOrCoordLocation | StopLocation | Innehåller själva svarsdata från tjänsten. Se ”Svarsdata” nedan. |
Svarsdata
Namn | Datatyp | Beskrivning |
stopLocationOrCoordLocation | Lista av element | Lista med de platser som hittats. Se ”StopLocation” och ”CoordLocation” nedan. |
StopLocation
Namn | Datatyp | Beskrivning |
Id | String | Reconstruction Id, se reseplanerarens dokumentation |
Name | String | Namn för hållplats. |
extId | String | HafasId för hållplatsen. Läs mer om HafasId i sektionen HafasId och SiteId. |
Lat | Double | Lat. |
Lon | Double | Long. |
Weight | Integer | Anger hur mycket en station används, ju högre värde desto större användning. |
Dist | Integer | Distans i meter från försedd koordinat i anropet. |
Products | Integer | Se beskrivning för anropsparametrar |
CoordLocation
Namn | Datatyp | Beskrivning |
Id | String | Reseplanerar reconstruction Id, se reseplanerarens documentation |
Name | String | Namn för POI. |
Lat | String | Lat. |
Lon | String | Long. |
Dist | String | Distans i meter från försedd koordinat i anropet. |
Type | String | Visar i nuläget endast ”POI” |
LocationNotes | Lista av element | Se nedan |
LocationNote
Namn/värde lista.
Dessa värden gäller för närvarande men kan komma att ändras utan att information skickas i förväg.
Key | Value |
PI | Unikt id |
PC | POI kategori: |
PT | POI typ: Hospital, School, Theatre, University, Castle, Park, Library, Mall, Attraction, Chalet, Museum, Viewpoint eller Zoo |
CN | Namnet på kommunen som POI:en befinner sig i. |
HafasId och SiteId
Information om hur HafasId byggs på SiteId, StopId och StopAreaId.
HafasId nyttjas bland annat i Reseplanerar api’et.
Typ | Beskrivning | Exempel |
SiteId | 3FG1EDCBA där där FGEDCBA är de 7 sista sifforna i site.number utfyllt med nollor. | SiteId: 9600 HafasId: 300109600 |
StopId | 4FG1EDCBA där GFEDCBA är journeyPatternPoint utfyllt med nollor. | JourneyPatternPoint.Number: 56789 HafasId: 400156789 |
StopAreaId | 2FG1EDCBA där FEDCBA är stopArea.number utfyllt med nollor | StopArea.number: 81025 HafasId: 200181025 |
XSD
Url
Exempel:
https://api.sl.se/api2/nearbystops/xsd.xml?key=<DIN API NYCKEL>&xsdname= hafasRestLocation.xsd
Felmeddelanden
Statuskod | Meddelande |
1001 | problem with request: Key is undefined Nyckel har ej skickats med. |
1002 | problem with request: Key is invalid Nyckel är ogiltig |
1003 | Invalid api Ogiltigt api |
1004 | problem with request: This api is currently not available for keys with priority above 2 |
1005 | Nyckel finns, men ej för detta api problem with request: Invalid api for key |
1006 | To many requests per minute För många anrop per minut, för den profil som används |
1007 | To many requests per month För många anrop per månad, för den profil som används |
Övriga felmeddelanden
Felmeddelanden från api’et är idag på svenska eller engelska beroende på vilket språk som efterfrågats i urlanropet.
Statuskod | Meddelande |
R0001 | Unknown service method |
R0002 | Invalid or missing request parameters. |
R0007 | Internal communication error. |