Helemaal de weg kwijt?
We helpen je op weg om een vliegende start te maken met de Spikkl adresvalidatie. Lukt het even niet, vraag om hulp en we helpen je zo snel mogelijk verder.
Request
Request format
The Spikkl API request takes the following form:
https://api.spikkl.nl/geo/{country}/{service}.{format}?parameters
where country
is the country in which you look for a location. For now, Dutch postal codes are supported.
where format
is the response format which is currently json
(Javascript Object Notation) only.
where service
may be either of the following values:
lookup
the service to validate and complete the provided address details.reverse
the service to geocode the provided coordinate to an address.
For all requests HTTPS is recommended, especially requests holding sensitive user data, such as a user's location. HTTPS encryption makes an application more secure and more resistant. URL's must be properly encoded to be valid. As is standard in URL's, parameters are separated using the ampersand (&
) character.
Required parameters
Every request should contain the key
parameters. An request may require other parameters, depending on the service.
Parameter | Description |
---|---|
key |
The API key. The key identifies the application for purposes of quota management. |
Optional parameters
Parameter | Description |
---|---|
tag |
To tag the request for statistical purposes. |
filter |
To restrict the keys returned by the API. |
Language
By default, the names of the components are returned in the default language of the requested country. The API accepts values from the Accept-Language
header to localize some components. If a name is not available in the preferred language, the API uses the closest match.
Lookup Request
The Spikkl API lookup request takes the following form:
https://api.spikkl.nl/geo/{country}/lookup.json?key=API_KEY&postal_code=1234AA&street_number=1
In addition to the key
parameter, the lookup requests accepts multiple parameters as search query, where postal_code
is required.
Parameter | Description |
---|---|
postal_code |
Always required. When the postal_code parameter is not accompanied with other components, the API may return all available street names for the provided postal code. When accompanied with other parameters, the API may return a valid address location. |
street_number |
Required when validating an address location, not required for searching street names only. |
street_number_suffix |
Optional as addition to the street number. |
Using your API key, you can run and test the lookup request easily in Postman.
Reverse Lookup Request
The Spikkl API lookup request takes the following form:
https://api.spikkl.nl/geo/{country}/reverse.json?key=API_KEY&longitude=5&latitude=52
In addition to the key
parameter, the reverse lookup requests accepts only two parameters, both required. All coordinates use the WGS84
reference coordinate system.
Parameter | Description |
---|---|
longitude |
The longitude (x-axis) value specifying the closest address location. |
latitude |
The latitude (y-axis) value specifying the closest address location. |
Use Postman to test en run the reverse lookup request as well.