--- title: Determine estimated arrival times and distances to one or more destinations framework: applemapsserverapi role: symbol role_heading: Web Service Endpoint path: applemapsserverapi/-v1-etas --- # Determine estimated arrival times and distances to one or more destinations Returns the estimated time of arrival (ETA) and distance between starting and ending locations. ## URL GET https://maps-api.apple.com/v1/etas ## Query Parameters origin: The starting point for estimated arrival time requests, specified as a comma-separated string that contains the latitude and longitude. For example, origin=37.331423,-122.030503. destinations: Destination coordinates represented as pairs of latitude and longitude separated by a vertical bar character (”|”). For example, destinations=37.32556561130194,-121.94635203581443|37.44176585512703,-122.17259315798667. The parameter must specify at least one destination coordinate, but no more than 10 destinations. Specify the location as a comma-separated string that contains the latitude and longitude. transportType: The mode of transportation to use when estimating arrival times. departureDate: The time of departure to use in an estimated arrival time request, in ISO 8601 format in UTC time. For example, departureDate=2020-09-15T16:42:00Z. If you don’t specify a departure date, the server uses the current date and time when you make the request. arrivalDate: The intended time of arrival in ISO 8601 format in UTC time. ## Response Codes 200 OK: An array of EtaResponse objects that contain distance and time from the origin to each destination. 400 Bad Request: An ErrorResponse object that contains an error message and an array of strings that contain additional details. 401 Unauthorized: An ErrorResponse object that contains an error message that indicates the Maps access token is missing or invalid, and an array of strings that contains additional details about the error. 429 : An ErrorResponse object that indicates the call exceeds the daily service call quota for the authorization token presented. The app should try again later. If your app requires a larger daily quota, submit a quota increase request form. 500 Internal Server Error: An ErrorResponse object that contains a server error message and an array of strings that describe additional details about the error. ## Discussion Discussion Example ## See Also ### Directions - [Search for directions and estimated travel time between locations](applemapsserverapi/-v1-directions.md)