Off-Street Parking API Developer's Guide

Facilities by ID

The facilities/bulk resource allows you to retrieve dynamic and static information about a specific parking facilities.

Requests against this resource use the HTTP GET method.

Request Example

The code block below shows a search request for a facility with a specific id.

curl GET 
https://parking-v2.cit.cc.api.here.com/parking/facilities/bulk.xml
?id=50859985&id=50859984&id=276u33db-e63737ae997c4a1ab5a19c50a63af49e
-H "Authorization: Bearer {YOUR_TOKEN}"

Request Parameters

The table below documents both mandatory and optional request parameters supported by the facilities by PVID resource.

Parameter Required Description
id yes

Required parking facilities IDs - either pvId or facility id. Supports multiple values as follows: id=A&id=B&id=C... Items order in the response is not guaranteed. Might not match with order of requested IDs.

Non-existing IDs are ignored.

Maximum limit is 50 ID(s) per request.

content no

Limit the content in the response.

The possible values are:

  • dynamic (returns only dynamic data)
  • all (return both, static and dynamic, data)

Default: dynamic

arrival No

Expected time arrival at the destination in UTC format according to ISO 8601.

Note this parameter is mandatory for parking fee calculation and parking fee is calculated only when query parameter content=all.

Example: 2015-04-02T15:40:00.000Z

duration No

Estimated parking duration in minutes. Min value: 1. Max value: 20160 (two weeks)

Note this parameter is mandatory for parking fee calculation and parking fee is calculated only when query parameter content=all.

Response to this Request

Note: In case query parametercontent is ommited or is set to 'dynamic', response will contain ONLY dynamic data for each requested parking facility - ParkingFacilityAvailabilityType element.

For more information on responses to queries for a specific facility, see Parking Facilities Response.