Suggest API

Comprehensive documentation for integrating Cercalia’s Suggest API into your applications.

API Access

The Suggest API provides functionality for querying addresses, localities, and points of interest.

Base Service URLs:

  • Supported methods: GET or POST
  • Response formats: JSON

Introduction to the Cercalia Suggest API

The Suggest web service provides functionality for querying addresses, localities, and points of interest. This service allows you to:

Suggestion Requests:

  • Includes addresses, localities, and points of interest (POIs)
  • Does not include precise coordinates for addresses. A subsequent geocoding request is required to obtain detailed address coordinates

Geocoding Requests:

  • Retrieve the X and Y (longitude and latitude) coordinates of a specific address

Key Details

  • Suggestion requests already include the coordinates for each candidate, except for addresses, which only return the default street coordinate
  • For detailed portal coordinates, an additional geocoding request to the web service is required

Suggest Requests

Comprehensive documentation for integrating Cercalia’s Suggest API into your applications.

Geocoding Address Requests

Detailed documentation on how to perform geocoding address requests using Cercalia’s Suggest API.

POI Requests

Detailed documentation on how to perform POI suggestion requests using Cercalia’s Suggest API.

Bracket locality

Explanation on how to use brackets in the “t” parameter to differentiate the locality when searching with Cercalia’s Suggest API.

Examples requests

Detailed and explained requests

Languages

Suggest languages

Errors

Detailed documentation on error responses.