Home

Introduction

Geocoding API

version 1

Service that's provide easy access, flexibility and simplicity in question of finding locations. Features of geocoding service didn't end in just providing city name, it's capable to work with SeaPorts, AirPorts and provide names, coords, relations, boundaries, neighbors, timezone and much more.

OpenAPI Specification

Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.

General information

Geocoding API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API endpoint#

1https://geocoding.searates.com

All endpoints are only accessible via HTTPS and are located at geocoding.searates.com

Lookup location by ID

post/geo/lookup

POST Request body variants

Headers

Content-Typeapplication/json

Body Parameters
  • idOptionalno type
Response example
OK

Find location by input struct

post/geo/search
Headers

Content-Typeapplication/json

Body Parameters
  • countryOptionalobject or null

    Has a prority. If we have code, we will ignore name

  • adminOptionalobject or null

    Has priority. id ?? code ?? name

  • cityOptionalobject or null
  • tradeportOptionalobject or null
Response example
OK

Find location by single line input

get/geo/reverse
Headers

Content-Typeapplication/json

Query Parameters
  • qOptionalstring

    Miami, Florida, USA

Response example
OK

Get a list of possible location

get/geo/autocomplete
Headers

Content-Typeapplication/json

Body Parameters
  • countryOptionalobject or null

    Has a prority. If we have code, we will ignore name

  • adminOptionalobject or null

    Has priority. id ?? code ?? name

  • cityOptionalobject or null
  • tradeportOptionalobject or null

Get detailed info about specific location

get/geo/place-details
Headers

Content-Typeapplication/json

Query Parameters
  • idOptionalstring

    Any ID, CountryID || AdminID || CityID || TradePortID