{"source":"entur","operation":"find_live_vehicles_nearby","description":"Find public-transport vehicles reporting live positions near a point.","parameters":[{"name":"lat","schema":{"type":"number"},"required":true,"default":null,"description":"WGS84 latitude."},{"name":"lon","schema":{"type":"number"},"required":true,"default":null,"description":"WGS84 longitude."},{"name":"radius_km","schema":{"type":"number"},"required":false,"default":2,"description":"Circular search radius, 0.1-50 km (default 2)."},{"name":"mode","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Optional AIR, BUS, COACH, FERRY, METRO, TAXI, TRAM or RAIL."},{"name":"limit","schema":{"type":"integer"},"required":false,"default":50,"description":"Maximum vehicles to return, 1-200."},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page."}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/entur/find_live_vehicles_nearby?lat={lat}&lon={lon}&radius_km=2&mode={mode}&limit=50&offset=0","schema_scope":"#/data in the successful operation envelope","response_schema":{"type":"object","properties":{"center":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"additionalProperties":false,"required":["lat","lon"]},"radius_km":{"type":"number"},"mode":{"type":["string","null"]},"total":{"type":"integer"},"returned":{"type":"integer"},"vehicles":{"type":"array","items":{"type":"object","properties":{"vehicle_id":{"type":["string","null"]},"mode":{"type":["string","null"]},"line_id":{"type":["string","null"]},"line":{"type":["string","null"]},"line_name":{"type":["string","null"]},"origin":{"type":["string","null"]},"destination":{"type":["string","null"]},"lat":{"type":["number","null"]},"lon":{"type":["number","null"]},"distance_km":{"type":["number","null"]},"bearing":{"type":["number","null"]},"speed":{"type":["number","null"]},"delay_seconds":{"type":["number","null"]},"in_congestion":{"type":["boolean","null"]},"occupancy":{"type":["string","null"]},"last_updated":{"type":["string","null"],"format":"date-time"},"service_journey_id":{"type":["string","null"]},"service_date":{"type":["string","null"],"format":"date"},"operator":{"type":["string","null"]},"operator_id":{"type":["string","null"]},"codespace":{"type":["string","null"]}},"additionalProperties":false}}},"additionalProperties":false,"required":["center","radius_km","total","returned","vehicles"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["transit_stop","place"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"error_contract":{"scope":"top-level HTTP error response; never part of a success payload","schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}},"additionalProperties":false,"required":["code","message","retryable"]},"suggestion":{"type":"string"},"_meta":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time"},"language":{"type":"string","const":"en"},"content_languages":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object"}}},"required":["retrieved_at","language","content_languages","sources"]},"_links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"api_index":{"type":"string","format":"uri"},"feedback":{"type":"string","format":"uri"}},"required":["self","api_index","feedback"],"additionalProperties":false}},"additionalProperties":false,"required":["error","suggestion","_meta","_links"]},"statuses":{"400":{"codes":["MISSING_PARAMETER","INVALID_PARAMETER","INVALID_REQUEST"],"retryable":false},"404":{"codes":["SOURCE_NOT_FOUND","OPERATION_NOT_FOUND","ENTITY_NOT_FOUND"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"502":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":true}}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/entur/find_live_vehicles_nearby/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/entur/find_live_vehicles_nearby","source":"https://allemannsdata.com/wiki/api/v1/kilder/entur","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"},"output_fields":["center","center.lat","center.lon","radius_km","mode","total","returned","vehicles","vehicles[].vehicle_id","vehicles[].mode","vehicles[].line_id","vehicles[].line","vehicles[].line_name","vehicles[].origin","vehicles[].destination","vehicles[].lat","vehicles[].lon","vehicles[].distance_km","vehicles[].bearing","vehicles[].speed","vehicles[].delay_seconds","vehicles[].in_congestion","vehicles[].occupancy","vehicles[].last_updated","vehicles[].service_journey_id","vehicles[].service_date","vehicles[].operator","vehicles[].operator_id","vehicles[].codespace"],"output_fields_truncated":false,"canonical_field_aliases":{"latitude":["center.lat","vehicles[].lat"],"longitude":["center.lon","vehicles[].lon"]},"response_example":{"source":"entur","operation":"find_live_vehicles_nearby","parameters":{"lat":59.91,"lon":10.75,"radius_km":2,"mode":"example value","limit":50},"data":{"center":{"lat":59.91,"lon":10.75},"radius_km":1.0,"mode":"example value","total":1,"returned":1,"vehicles":[{"vehicle_id":"example-id","mode":"example value","line_id":"example-id","line":"example value","line_name":"Example","origin":"example value","destination":"example value","lat":59.91,"lon":10.75,"distance_km":1.0,"bearing":1.0,"speed":1.0,"delay_seconds":1.0,"in_congestion":true,"occupancy":"example value","last_updated":"2026-01-15T12:00:00Z","service_journey_id":"example-id","service_date":"2026-01-15","operator":"example value","operator_id":"example-id","codespace":"example value"}]},"entities":[{"type":"place","id":"59.91,10.75","name":"59.91, 10.75","source":"entur","description":"Coordinate used as the operation input.","coordinates":{"lat":59.91,"lon":10.75,"crs":"WGS84"}}],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"entur","name":"Entur","description":"National stop search, journey planning, departures, live vehicle positions and service alerts.","cache_ttl_seconds":30,"documentation":"https://developer.entur.org/pages-intro-getstarted/","rate_limit":"The gateway identifies the client to Entur; excessive traffic may be limited."}]},"_provenance":{"data":{"source":"entur","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/entur"},"entities":{"source":"entur","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/entur","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/entur/find_live_vehicles_nearby","source":"https://allemannsdata.com/wiki/api/v1/kilder/entur","wiki":"https://allemannsdata.com/wiki/kilder/entur/find_live_vehicles_nearby/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}