arrival-and-departure-for-stop Method

Get info about a single arrival and departure for a stop.

Example Request

https://api.pugetsound.onebusaway.org/api/where/arrival-and-departure-for-stop/1_75403.json?key=TEST&tripId=1_604670535&serviceDate=1710918000000

Example Response

{"code":200,"currentTime":1710979160311,"data":{"entry":{"actualTrack":"","arrivalEnabled":true,"blockTripSequence":2,"departureEnabled":true,"distanceFromStop":-86260.03203224196,"frequency":null,"historicalOccupancy":"","lastUpdateTime":1710979086000,"numberOfStopsAway":-174,"occupancyStatus":"","predicted":true,"predictedArrivalInterval":null,"predictedArrivalTime":1710959774000,"predictedDepartureInterval":null,"predictedDepartureTime":1710959774000,"predictedOccupancy":"","routeId":"1_100214","routeLongName":"","routeShortName":"372E","scheduledArrivalInterval":null,"scheduledArrivalTime":1710959580000,"scheduledDepartureInterval":null,"scheduledDepartureTime":1710959580000,"scheduledTrack":"","serviceDate":1710918000000,"situationIds":[],"status":"default","stopId":"1_75403","stopSequence":39,"totalStopsInTrip":47,"tripHeadsign":"U-District Station","tripId":"1_604670535","tripStatus":{"activeTripId":"1_604669915","blockTripSequence":6,"closestStop":"1_23905","closestStopTimeOffset":0,"distanceAlongTrip":17544.75847875161,"frequency":null,"lastKnownDistanceAlongTrip":0,"lastKnownLocation":{"lat":47.67626953125,"lon":-122.30064392089844},"lastKnownOrientation":0,"lastLocationUpdateTime":1710979086000,"lastUpdateTime":1710979086000,"nextStop":"1_23905","nextStopTimeOffset":0,"occupancyCapacity":0,"occupancyCount":0,"occupancyStatus":"","orientation":268.65466459784096,"phase":"in_progress","position":{"lat":47.676273613612494,"lon":-122.3006519855894},"predicted":true,"scheduleDeviation":194,"scheduledDistanceAlongTrip":17544.75847875161,"serviceDate":1710918000000,"situationIds":[],"status":"SCHEDULED","totalDistanceAlongTrip":22176.747926117183,"vehicleId":"1_6936"},"vehicleId":"1_6936"},"references":{"agencies":[{"disclaimer":"","email":"","fareUrl":"https://kingcounty.gov/en/dept/metro/fares-and-payment/prices","id":"1","lang":"EN","name":"Metro Transit","phone":"206-553-3000","privateService":false,"timezone":"America/Los_Angeles","url":"https://kingcounty.gov/en/dept/metro"}],"routes":[{"agencyId":"1","color":"","description":"UW/Cascadia College - University District","id":"1_100214","longName":"","nullSafeShortName":"372","shortName":"372","textColor":"","type":3,"url":"https://kingcounty.gov/en/dept/metro/routes-and-service/schedules-and-maps/372.html"},{"agencyId":"1","color":"","description":"Loyal Heights - University District","id":"1_100225","longName":"","nullSafeShortName":"45","shortName":"45","textColor":"","type":3,"url":"https://kingcounty.gov/en/dept/metro/routes-and-service/schedules-and-maps/045.html"},{"agencyId":"1","color":"","description":"Northgate - Roosevelt - University District","id":"1_100259","longName":"","nullSafeShortName":"67","shortName":"67","textColor":"","type":3,"url":"https://kingcounty.gov/en/dept/metro/routes-and-service/schedules-and-maps/067.html"}],"situations":[],"stopTimes":[],"stops":[{"code":"75403","direction":"SW","id":"1_75403","lat":47.654503,"locationType":0,"lon":-122.30513,"name":"East Stevens Way NE & Benton Ln","parent":"","routeIds":["1_100225","1_100259","1_100214"],"staticRouteIds":["1_100225","1_100259","1_100214"],"wheelchairBoarding":"ACCESSIBLE"},{"code":"23905","direction":"S","id":"1_23905","lat":47.676273,"locationType":0,"lon":-122.300743,"name":"25th Ave NE & NE 65th St","parent":"","routeIds":["1_100214"],"staticRouteIds":["1_100214"],"wheelchairBoarding":"ACCESSIBLE"}],"trips":[{"blockId":"1_7087104","directionId":"1","id":"1_604670535","peakOffpeak":0,"routeId":"1_100214","routeShortName":"372E","serviceId":"1_45626","shapeId":"1_20372015","timeZone":"","tripHeadsign":"U-District Station Lake City","tripShortName":"EXPRESS"},{"blockId":"1_7087104","directionId":"1","id":"1_604669915","peakOffpeak":0,"routeId":"1_100214","routeShortName":"372E","serviceId":"1_45626","shapeId":"1_20372015","timeZone":"","tripHeadsign":"U-District Station Lake City","tripShortName":"EXPRESS"}]}},"text":"OK","version":2}

Request Parameters

id - the stop id, encoded directly in the URL:
- http://api.pugetsound.onebusaway.org/api/where/arrival-and-departure-for-stop/[ID GOES HERE].xml
tripId - required the trip id of the arriving transit vehicle
serviceDate - required the service date of the arriving transit vehicle
vehicleId - the vehicle id of the arriving transit vehicle (optional)
stopSequence - the stop sequence index of the stop in the transit vehicle’s trip
time - by default, the method returns the status of the system right now. However, the system can also be queried at a specific time. This can be useful for testing. See timestamps for details on the format of the time parameter.

The key here is uniquely identifying which arrival you are interested in. Typically, you would first make a call to arrivals-and-departures-for-stop to get a list of upcoming arrivals and departures at a particular stop. You can then use information from those results to specify a particular arrival. At minimum, you must specify the tripId and serviceDate. Additionally, you are also encouraged to specify the vehicleId if available to help disambiguate between multiple vehicles serving the same trip instance. Finally, you are encouraged to specify the stopSequence. This helps in the situation when a vehicle visits a stop multiple times during a trip (it happens) plus there is performance benefit on the back-end as well.

Response

The method returns an <arrivalAndDeparture/> element as its content.