Search for Localities and Postcode

Web Service to Search for Localities and Postcode.
  1. Introduction
  2. Required parameters
  3. Optional parameters
  4. Localities predictions responses
  5. Predictions
  6. Countries included for Postcode search

Introduction

The Woosmap Localities service is a web service that returns city names and postcodes predictions in response to an HTTP request. The request specifies a textual search string and optional geographic bounds. The service can be used to provide autocomplete functionality for text-based geographic searches.

The Woosmap Localities service can match on full words as well as substrings. You can therefore send queries as the user types, to provide on-the-fly postcodes or city names predictions.

The returned predictions are designed to be presented to the user to aid them in selecting the desired postcode or city name. All predictions contains additional data (see below) to use directly the results without needing a “Detail request”.

Woosmap Localities provides city name search Worldwide and postcode search for Europe (see countries included).

A Woosmap Localities autocomplete request is an HTTP URL of the following form:

https://api.woosmap.com/localities/autocomplete/?parameters

Required parameters

Certain parameters are required to initiate a Localities request. As is standard in URLs, all parameters are separated using the ampersand (&) character. The list of parameters and their possible values are enumerated below.

https://api.woosmap.com/localities/autocomplete/?input=paris&key=woos-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
https://api.woosmap.com/localities/autocomplete/?input=7501&key=woos-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx

Optional parameters

.../localities/autocomplete/?input=lond&key=[APIKey]&types=locality&components=country:gb&language=en

Localities predictions responses

Localities provides a JSON response containing one root elements:

        {
          "localities": [
            {
              "description": "92100, France",
              "name": "92100",
              "admin_0": "France",
              "type": "postal_code",
              "viewpoint": {
                "bounds": {
                  "east": 2.369166,
                  "south": 48.845943,
                  "north": 48.86196,
                  "west": 2.344758
                }
              },
              "location": {
                "lat": 48.88731,
                "lng": 2.3067129
              }
            },
            {...},
            {...},
            {...}
          ]
        }

Predictions

Each prediction result contains the following fields:

Austria Austria Belgium Belgium Denmark Denmark
Finland Finland France France Germany Germany
Iceland Iceland Italy Italy Luxembourg Luxembourg
Malta Malta Netherlands Netherlands Norway Norway
Portugal Portugal Spain Spain Sweden Sweden
Switzerland Switzerland United Kingdom United Kingdom