Location service

Search for an address

Activity name : <a href="https://developer.loket.nl/Activities/GetSearchAddressByBearerToken" target="_blank">GetSearchAddressByBearerToken</a>

Use fuzzy search to find an address. The response returns the GEO coördinates that can be used to calculate a route.

get/address/search

Request

  • Base URL
    https://api.loket.nl
  • URL
    https://api.loket.nl/address/search
  • Auth
    none required

Query parameters

querystring required

A term by wich the address might be found the more detailed the better the search results

latnumber double

latitude for the bias in the search results. Results will be ordered in likelyhood to be relevant to the given latitude (and longitude)

lonnumber double

longitude for the bias in the search results. Results will be ordered in likelyhood to be relevant to the given longitude (and latitude)

topinteger

the top x number of results that are returned. If not supplied 5 results are returned

Headers

Authorizationstring required
Example:Bearer <TOKEN>

A valid Bearer token for authorizing the request.

Acceptstring required
Example:application/json;version=2018-01-01

The accept header is used to influence what type of output is returned and in most cases the version of the output

Response

OK

totalSizeinteger

Total number of records, taking into account the given filter.

pageSizeinteger

Number of records in the response

totalPagesinteger

Number of pages available

currentPageinteger

Current page returned in the response

Example response

{
  "totalSize": 650,
  "pageSize": 250,
  "totalPages": 3,
  "currentPage": 2,
  "version": {
    "resourceVersion": "2018-12-31"
  },
  "messages": [
    {
      "type": "Warning",
      "description": "<some warning>",
      "id": "904d6856-6034-4624-bcbc-886188c115c5",
      "code": 12
    }
  ],
  "_embedded": [
    {
      "pointOfInterest": {
        "name": "Van Spaendonck Groep"
      },
      "address": {
        "freeformAddress": "Reitseplein 1, 5037 AA Tilburg",
        "countryCode": "NL"
      },
      "position": {
        "latitude": 51.585996,
        "longitude": 5.585996
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 6 revisions of this API.