GET
/
V2
/
results
/
parkingplaces
/
curl --location 'https://api.truemetrics.cloud/V2/results/parkingplaces?lat=50.3&lon=13.5&distance=500' \
--header 'x-api-key: YOURKEY' \
--header 'Content-Type: application/json'
{
    "results": [
        {
            "id": "af25987c50ad6fe71d622852623c9fa95c07c6a72651470b0b4ffc62dc4c8801",
            "lat": "0",
            "lon": "0"
        }
    ],
    "message": "successfully retrieved 1 entry."
}

Query Parameters

The API provides two distinct methods for accessing parking place information:

Access via Address

This method is ideal for users interested in retrieving parking place data specifically associated with a given address. By supplying the address, the API returns information on parking places that have been utilized in relation to that address. This approach is particularly useful for users focusing on parking data in a defined area or seeking historical parking usage at a particular location.

Parameter for access via Address

street
string

Name of the Street

streetnumber
string

Streetnumber of the address.

locality
string

Locality of the address.

postalcode
string

Postcal code of the address.

country
string

TCountry code in ISO 3166-1 alpha-2 format.

Access via Coordinates and Distance:

For a broader search, this method allows users to specify a set of coordinates and a distance parameter. The API then returns a list of all parking places located within the specified radius from the given point. The distance parameter is defined by the user and is measured using the Chebyshev distance metric. This metric, also known as the maximum metric, calculates the greatest of the differences along latitude and longitude.

Parameter for access via Coordinates and Distance

lat
float

Latitude of the center coordinates.

lon
float

Longitude of the center coordinates.

distance
float

Distance in meters in which the parking places shall be searched. The maximal value is 1000.

Parameters for both access methods

Content-Type
string
x-api-key
string

Response

results
array

An array of parking places for the given address.

message
string

A message indicating whether the call was successful.