Locatienet API (1.0)

Go to your Account to get your ApiKey

Time&Distance

Solution for determining distances and travel time.

Search for locations using a free-form text input.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
object (LocateOptions)
text
string or null

A free-form text input.

country
string or null

Country code according to ISO 3166-1 alpha-2. Defaults to NL. The search will be restricted to this country. When empty, all countries contained in the geocoding data will be included in the search.

Responses

Request samples

Content type
application/json
{
  • "text": "1012JS in Amsterdam",
  • "country": "NL"
}

Response samples

Content type
application/json
[
  • {
    }
]

Search for locations using structured address input.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
object (LocateOptions)
object (Address)

Represents the address of a geographical object. Where a string, such as a city or street name, is available in multiple languages, it is returned in the default language specified by the object's location, i.e. in which country it is located. Because addressing schemes vary strongly between countries, most fields are optional.

Responses

Request samples

Content type
application/json
{
  • "address": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

Calculates and returns basic route information and polyline.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
Array of objects or null (Location)

A list of sequential locations

object (RouteOptions)
object (ResponseExtras)

Responses

Request samples

Content type
application/json
{
  • "locations": [
    ],
  • "options": {
    }
}

Response samples

Content type
application/json
{
  • "distance": 0.1,
  • "travelTime": 0.1,
  • "trafficDelay": 0.1,
  • "waypoints": [
    ],
  • "polyline": [
    ],
  • "meta": {
    }
}

A list of available countries.

Authorizations:
X-API-KEYapikey

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Map&Route

Solution for creating maps and route descriptions

Search for locations using a free-form text input.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
object (LocateOptions)
text
string or null

A free-form text input.

country
string or null

Country code according to ISO 3166-1 alpha-2. Defaults to NL. The search will be restricted to this country. When empty, all countries contained in the geocoding data will be included in the search.

Responses

Request samples

Content type
application/json
{
  • "text": "1012JS in Amsterdam",
  • "country": "NL"
}

Response samples

Content type
application/json
[
  • {
    }
]

Search for locations using structured address input.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
object (LocateOptions)
object (Address)

Represents the address of a geographical object. Where a string, such as a city or street name, is available in multiple languages, it is returned in the default language specified by the object's location, i.e. in which country it is located. Because addressing schemes vary strongly between countries, most fields are optional.

Responses

Request samples

Content type
application/json
{
  • "address": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

Search for addresses using structured coordinate input.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
object (LocateOptions)
object (Coordinate)

A coordinate is defined by its x and y values, specifying the geographical point in a two-dimensional coordinate system

Responses

Request samples

Content type
application/json
{
  • "coordinate": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]

Calculates and returns basic route information, descriptions and polyline.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
Array of objects or null (Location)

A list of sequential locations

object (RouteOptions)
object (ResponseExtras)

Responses

Request samples

Content type
application/json
{
  • "locations": [
    ],
  • "options": {
    }
}

Response samples

Content type
application/json
{
  • "distance": 0.1,
  • "travelTime": 0.1,
  • "trafficDelay": 0.1,
  • "waypoints": [
    ],
  • "descriptions": [
    ],
  • "polyline": [
    ],
  • "meta": {
    }
}

The required map section is described by its tile key. Use https://[tileserver|tile[0|1|2|3]].locatienet.com/{z}/{x}/{y}.png?apikey={your apikey}

Authorizations:
X-API-KEYapikey

Responses

Response samples

Content type
application/json
"string"

The required map is described by its bounds..

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
object (MapImageOptions)
object (MapMapOptions)
object (BoundingBox)

Boundaries are used for defining the minimal boundary rectangle of a geographical object. It contains the minimum and maximum values for x and y dimension.

Responses

Request samples

Content type
application/json
{
  • "imageOptions": {
    },
  • "mapOptions": {
    },
  • "bounds": {
    }
}

Response samples

Content type
application/json
{
  • "image": "string",
  • "bounds": {
    },
  • "zoom": 0.1
}

The required map is described by its center coordinate and its zooming.

Authorizations:
X-API-KEYapikey
Request Body schema: application/json
object (MapImageOptions)
object (MapMapOptions)
object (Coordinate)

A coordinate is defined by its x and y values, specifying the geographical point in a two-dimensional coordinate system

zoom
integer <int32>

The geographical resolution at which to display the map, where zoom 0 corresponds to a map of the Earth fully zoomed out, and larger zoom levels zoom in at a higher resolution. Offering a map of the entire Earth as a single image would either require an immense map, or a small map with very low resolution. As a result, map images are broken up into map 'tiles' and 'zoom levels'. At low zoom levels, a small set of map tiles covers a wide area; at higher zoom levels, the tiles are of higher resolution and cover a smaller area. Fractional values are allowed. The zoom is currently restricted to the range 0..22. Range: 0 ≤ value.

Responses

Request samples

Content type
application/json
{
  • "imageOptions": {
    },
  • "mapOptions": {
    },
  • "center": {
    },
  • "zoom": 12
}

Response samples

Content type
application/json
{
  • "image": "string",
  • "bounds": {
    },
  • "zoom": 0.1
}

A list of available countries.

Authorizations:
X-API-KEYapikey

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Traffic API

Traffic information

A GeoJson feature collection with the current (dutch) traffic situation. Includes congestions and major roadworks

Authorizations:
X-API-KEYapikey
Request Body schema: application/json

Options such as language of the output

countries
Array of strings or null

list of countries to include in the traffic information (currently only Dutch and Belgium traffic information is available)

language
string or null

The language used for geographic names. Defaults to nl. This standard allows to use two-letter ISO 639-1 codes

Responses

Request samples

Content type
application/json
{
  • "countries": [
    ],
  • "language": "nl"
}