Geocoding

Forward geocode.

Turn a place name or address into coordinates. Returns a GeoJSON FeatureCollection ranked by relevance.

Quota cost: 1 unit per call.

get/search/geocode/v1/forward

Request

  • Base URL: https://api.rijwind.com
  • URL: https://api.rijwind.com/search/geocode/v1/forward
  • Auth: HTTP bearer

Query parameters

qstring required

Free-text query.

langstring

Result language: en, de, fr, or default for local names (also the fallback when a result has no name in the requested language). Omit for local names; any other value is rejected with 400 bad_request.

limitinteger

Maximum number of results.

latnumber double

Bias results toward this latitude.

lonnumber double

Bias results toward this longitude.

bboxstring

Restrict results to a bounding box: minLon,minLat,maxLon,maxLat.

Response

Forward-geocode results.

typestring required

Example response

{
  "features": [
    {
      "geometry": {
        "coordinates": [
          4.9041,
          52.3676
        ],
        "type": "Point"
      },
      "properties": {
        "city": "Amsterdam",
        "country": "Netherlands",
        "countrycode": "NL",
        "name": "Damrak",
        "postcode": "1012",
        "state": "North Holland",
        "street": "Damrak",
        "type": "street"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.