Arrive Static Feed

Summary

The Arrive static feed enables data partners to programmatically consume a snapshot of all Arrive locations and purchase options. The feed is updated daily and contains data on thousands of locations.

Contact the platform team to learn more: partner-support@arrive.com

Version Changes

v1.0: No changes in this version v1.1: Add amenities, capacity, hours of operation, and polygon v1.2: Add type v1.3: Add STP fields

Endpoints and Authentication

• Sandbox https://api.sandbox.parkwhiz.com/v4/static_feed/feed.json
• Production https://api.parkwhiz.com/v4/static_feed/feed.json

Usage: These endpoints are available to Arrive partners with the 'data' api scope. Send a GET request to the above endpoints with the parameters client_id=<your client id> and client_secret=<your client secret>

Data Description

Static Feed Model

Field	Type	Description	Example
amenities	array	The amenities that are common to all purchase options of a location	[{"name":"Handicap"},{"name":"Unobstructed"}] See amenities definitions below
address	string	Street address	"2855 Telegraph Ave."
canonical_location_id	string	This location's primary location, not applicable to all locations	"1501"
capacity	integer	Location capacity, not available at all locations	50
city	string	Location city	"Berkeley"
country	string	The ISO 3166-1 alpha-2 code indicating the location's country	"US"
coordinates	object	Lat/Long of location	{"latitude":37.8582322,"longitude": -122.2591526}
description	string	Description of the location	"This is an open air parking lot with parking on three sides of the building. Enjoy a pleasant walk to the stadium and an easy exit from Berkeley after the game."
id	string	Location's ID	34
images	array	Image URL's and image metadata	[{"height":479,"url":"https://d2uqqhmijd5j2z.cloudfrontnet/files/13129/galery/13129.png","width": 800},{"height":440,"url":"https://d2uqqhmijd5j2z.cloudfront.net/files/13132/gallery/13132.png","width": 800}]
is_tap_to_pay_enabled	boolean	Indicates if the location supports Scan to Pay	true
is_tap_to_pay_vehicle_required	boolean	Indicates if this Scan to Pay location requires a vehicle for purchase. If this value is false then this field is omitted from the feed	true
msa	string	Metropolitan statistical area	"San Francisco"
name	string	Location's name	"Ace Parking - 2855 Telegraph Building"
operating_hours	array	Location hours of operation	see Time Period Model below
polygon	array	Array of lat/long objects defining the 2 dimenstional geographical footprint of location	[{"latitude":37.8582322,"longitude": -122.2591526}, etc.]
postal_code	string	Location postal code	"94705"
products	array	Details on the various purchase options, events, and airports associated with this location	see Products Model below
rate_tables	array	Location rate tables	{"rate_tables": [{"rates": [{"duration": 60, "price": {"USD": "2.00"}}], "rate_period": { ... }}]} where "rate_period" contains a Time Period Model
reservable	boolean	Indicates whether or not the location will be available in the future. If this value is false, then this location has zero available purchase options	true
seller	object	Seller name and id	{"id": 505,"name": "Ace Parking"}
state	string	State abreviation	"CA"
timezone	string	Location's timezone	"America/Los_Angeles"
type	string	The type of location. One of commercial_garage, commercial_lot, business, residential, on_street, or unknown	"commercial_garage"
url	string	URL to location on parkwhiz.com	"https://www.parkwhiz.com/p/berkeley-parking/2855-telegraph-ave"

Amenities Definitions

The amenity array contains the name of each location amenity that is available for all purchase options. For example, if the 'valet' amenity is only offered at the 'early bird' rate, then the 'valet' amenity will not be included in the amenity array of a location. Only amenities that are available for all purchase options will be included in the amenity array. Descriptions of each amenity are as follows:

Name	Description
Covered	Covered and protected from rain or snow
Restrooms	Restrooms available to customers
Unobstructed	Guaranteed to be unobstructed while the vehicle is parked
Accessible	Handicap accessible
Mobile Pass	Accepts smartphone mobile parking passes
Valet	Valet
Electric Car Charging	Electric vehicle charging available
Security	On-site security guard
Reentry	Customers allowed to leave and re-enter with same pass
Tailgating	Tailgating is allowed
Attendant	Attendant on-site

Time Period Model

Each instance of this Model represents a period of time in any arbitrary week of the year. An array of these can be used to represent when a garage is open to the public, or when specific rates are applicable.

Field	Type	Description
start_week_day	Integer	0-6, the day of the week at which this period starts.
start_time	String	'HH:MM', e.g. '13:00' for 1pm, or '00:00' for midnight.
end_time	String	'HH:MM', e.g. '13:00' for 1pm, or '00:00' for midnight.
end_days_later	Integer	The number of days offset from the start_day that this period ends

For example, a garage that is always open might have this record for its operating hours:

{
    "start_week_day": 0,
    "start_time": "00:00",
    "end_time": "00:00",
    "end_days_later": 7
}

A rate that is eligible from 8am-8pm on Monday would be represented as

{
    "start_week_day": 1,
    "start_time": "08:00",
    "end_time": "20:00",
    "end_days_later": 0
}

Product Model

The product array includes a snapshot of purchase options and event information. Some examples include: Early Bird, Morning, Afternoon, Evening, Weekend, Event Parking for Bears Game, Airport Parking, etc. For realtime price quotes please use the transactional API.

Field	Type	Description	Example
dates	object	start and end date of product	{"start": "2017-11-21T16:00:00-05:00","end": "2017-11-22T04:00:00-05:00"}
name	string	name of the product	Early Bird
price	object	Price estimate, the 'quote' endpoint will return the real price	{"USD": "10.00"}
type	string	Indicates the product type	offstreet
reservable	boolean	If the product is reservable via ParkWhiz	true
event	object	Event's information if the location has event based pricing	{"id": 590373,"name": "Cleveland Browns at Pittsburgh Steelers"}

Sample JSON

{
  "address": "2855 Telegraph Ave.",
  "amenities": [
    {
      "name": "Unobstructed"
    },
    {
      "name": "Handicap"
    }
  ],
  "canonical_location_id": "1501",
  "city": "Berkeley",
  "country": "US",
  "coordinates": {
    "latitude": 37.8582322,
    "longitude": -122.2591526
  },
  "description": "This is an open air parking lot with parking on three sides of the building. Enjoy a pleasant walk to the stadium and an easy exit from Berkeley after the game.",
  "id": "2302",
  "images": [
    {
      "height": 479,
      "url": "https://d2uqqhmijd5j2z.cloudfront.net/files/13129/gallery/13129.png",
      "width": 800
    },
    {
      "height": 440,
      "url": "https://d2uqqhmijd5j2z.cloudfront.net/files/13132/gallery/13132.png",
      "width": 800
    }
  ],
  "is_tap_to_pay_enabled": true,
  "is_tap_to_pay_vehicle_required": true,
  "msa": "San Francisco",
  "name": "Ace Parking - 2855 Telegraph Building",
  "operating_hours": [
    {
      "start_time": "-7:00",
      "end_time": "17:00",
      "end_days_later": 0,
      "start_week_day": 1
    },
    {
      "start_time": "-7:00",
      "end_time": "17:00",
      "end_days_later": 0,
      "start_week_day": 2
    },
    {
      "start_time": "-7:00",
      "end_time": "17:00",
      "end_days_later": 0,
      "start_week_day": 3
    },
    {
      "start_time": "-7:00",
      "end_time": "17:00",
      "end_days_later": 0,
      "start_week_day": 4
    },
    {
      "start_time": "-7:00",
      "end_time": "17:00",
      "end_days_later": 0,
      "start_week_day": 5
    },
    {
      "start_time": "-7:00",
      "end_time": "17:00",
      "end_days_later": 0,
      "start_week_day": 6
    },
    {
      "start_time": "-7:00",
      "end_time": "17:00",
      "end_days_later": 0,
      "start_week_day": 0
    }
  ],
  "products": [
       {
        "dates": {
          "start": "2018-04-19T05:00:00-05:00",
          "end": "2018-04-19T19:00:00-05:00"
        },
        "name": "Early Bird Parking",
        "price": {
          "USD": "10.00"
        },
        "reservable": true,
        "type": "offstreet"
      },
      {
        "dates": {
          "start": "2018-04-19T00:00:00-05:00",
          "end": "2018-04-20T00:00:00-05:00"
        },
        "name": "1 Day Parking",
        "price": {
          "USD": "10.00"
        },
        "reservable": true,
        "type": "airport"
      },
      {
        "event": {
          "id": 590373,
          "name": "Cleveland Browns at Pittsburgh Steelers"
        },
        "dates": {
          "start": "2017-12-31T15:00:00Z",
          "end": "2018-01-01T00:00:00Z"
        },
        "name": "Event Parking for Cleveland Browns at Pittsburgh Steelers",
        "price": {
          "USD": "22.73"
        },
        "reservable": true,
        "type": "event"
      }
    ],
  "postal_code": "94705",
  "rate_tables": [
    {
      "rates": [
        {
          "duration": 60,
          "price": {
            "USD": "2.00"
          }
        },
        {
          "price": {
            "USD": "12.00"
          },
          "until_time": "17:00"
        }
      ],
      "rate_period": {
        "start_time": "08:00",
        "end_time": "17:00",
        "end_days_later": 0,
        "start_week_day": 1
      }
    },
    {
      "rates": [
        {
          "duration": 60,
          "price": {
            "USD": "2.00"
          }
        },
        {
          "price": {
            "USD": "12.00"
          },
          "until_time": "17:00"
        }
      ],
      "rate_period": {
        "start_time": "08:00",
        "end_time": "17:00",
        "end_days_later": 0,
        "start_week_day": 2
      }
    },
    {
      "rates": [
        {
          "duration": 60,
          "price": {
            "USD": "2.00"
          }
        },
        {
          "price": {
            "USD": "12.00"
          },
          "until_time": "17:00"
        }
      ],
      "rate_period": {
        "start_time": "08:00",
        "end_time": "17:00",
        "end_days_later": 0,
        "start_week_day": 3
      }
    },
    {
      "rates": [
        {
          "duration": 60,
          "price": {
            "USD": "2.00"
          }
        },
        {
          "price": {
            "USD": "12.00"
          },
          "until_time": "17:00"
        }
      ],
      "rate_period": {
        "start_time": "08:00",
        "end_time": "17:00",
        "end_days_later": 0,
        "start_week_day": 4
      }
    },
    {
      "rates": [
        {
          "duration": 60,
          "price": {
            "USD": "2.00"
          }
        },
        {
          "price": {
            "USD": "12.00"
          },
          "until_time": "17:00"
        }
      ],
      "rate_period": {
        "start_time": "08:00",
        "end_time": "17:00",
        "end_days_later": 0,
        "start_week_day": 5
      }
    },
    {
      "rates": [
        {
          "duration": 60,
          "price": {
            "USD": "2.00"
          }
        },
        {
          "price": {
            "USD": "12.00"
          },
          "until_time": "17:00"
        }
      ],
      "rate_period": {
        "start_time": "00:00",
        "end_time": "00:00",
        "end_days_later": 0,
        "start_week_day": 6
      }
    },
    {
      "rates": [
        {
          "duration": 60,
          "price": {
            "USD": "2.00"
          }
        },
        {
          "price": {
            "USD": "12.00"
          },
          "until_time": "17:00"
        }
      ],
      "rate_period": {
        "start_time": "00:00",
        "end_time": "00:00",
        "end_days_later": 0,
        "start_week_day": 0
      }
    }
  ],
  "reservable": true,
  "seller": {
    "id": 505,
    "name": "Ace Parking"
  },
  "state": "CA",
  "timezone": "America/Los_Angeles",
  "url": "https://www.parkwhiz.com/p/berkeley-parking/2855-telegraph-ave"
}