getDestinationDataForOriginZIPCode

get

getDestinationDataForOriginZIPCode

Get data about trips from an origin, organized by where trips are ending at.

Resource URL

https://api-sandbox.arity.com/shared-mobility-insights/v1/zip-codes/{zipCode}/destination-zip-codes

Query Parameters


Name Values Description
tripType
(required)

Type of transportation (taxi data at ZIP level is only available in Chicago and New York City)

startDayOfWeek
(required)

Day of week marking start of time window

startHour
(required)

Integer from 0-23, with 0 representing 12 AM and 23 representing 11 PM

duration

Length of time window in hours. Integer from 1 to 168 allowed. For example, a startHour of 21 and duration of 4 will return data from 9 PM on the startDayOfWeek to 1 AM the next day. If no duration is entered, the default will be 1


Header Parameters


Name Values Description
Authorization
(required)

Value should be the word Bearer followed by a space and then the token (e.g., Bearer CW8abh5JkxZ5KYdAQQH0p9fTAicq). To generate a token, use the OAuth API.

zipCode 5-digit ZIP code to specify the origin of trips (e.g., 60607) true

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Response Error Details

  • HTTP Code
    Error Code
    Description
  • 400
    400

    Bad Request response

  • 401
    401

    Unauthorized response

  • 500
    500

    Server Error response

Resource Summary

Security

None

Category

Mobility Trends

Name Type Description
Name Type Description
originZipCode
.zipCode
string5-digit ZIP code to specify the origin of trips (e.g., 60606)
originZipCode
.relativityScore
numberValue showing relative popularity of the origin ZIP code compared to other ZIP codes in the metro area based on number of trips starting there. A value of 2 signifies that about twice as many trips start in this ZIP compared to the average ZIP, while a value of .5 signifies that about half as many do, during the requested time window.
originZipCode
.averageTripMiles
numberAverage length of all trips beginning in this ZIP during the requested time window
originZipCode
.averageTripDuration
numberAverage length, in minutes, of all trips beginning in this ZIP during the requested time window
destinationZipCodesarrayList of destination zip codes with traffic patterns going to the specified origin zip code.
destinationZipCodes[]
.zipCode
string5-digit ZIP code to specify where trips end (e.g., 60654)
destinationZipCodes[]
.tripPercentage
numberFor the specified time window, percentage of all trips beginning in the supplied origin ZIP code that ended in this destination ZIP code. Percentages are expressed as decimals (e.g., 0.12 = 12%)
destinationZipCodes[]
.averageTripMiles
numberAverage length of all trips ending in this ZIP and beginning from the the specified origin ZIP during the requested time window
destinationZipCodes[]
.averageTripDuration
numberAverage length, in minutes, of all trips ending in this ZIP and beginning from the specified origin ZIP during the requested time window

Working...

© 2019 Arity, LLC. All rights reserved.  | Privacy Policy | Terms of Use | Legacy APIs