Geolocation

IP Geolocation

Obtain information about visitor's location based on IP address of the incoming request.

get/geolocation/ip.json

Request

Base URL
https://api.maptiler.com
Auth
API key in query parameter key
TypeScript
https://skmtc.dev/maptiler/apis/maptiler-api-reference/docs/geolocation/ip.json/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

elevationboolean

Include elevation (in meters) in the results.

Response

Location of the client based on the IP address of the request.

countrystring

Name of the country

country_codestring

Two-letter code of the country

country_boundsnumber[]

Bounds of the country in WGS84 degrees [west, south, east, north].

country_languagesstring[]

Official country languages in ISO 639-1 format.

continentstring

Name of the continent

continent_codestring

Two-letter code of the continent

euboolean

Indicated whether the country is part of the European Union.

citystring

Name of the city

latitudenumber

Latitude of the location

longitudenumber

Longitude of the location

postalstring

Postal code

regionstring

If known, the ISO 3166-2 name for the first level region.

region_codestring

If known, the ISO 3166-2 code for the first level region.

timezonestring

Name of the timezone

elevationnumber

Elevation of the location in meters

Example response

{
  "country": "Switzerland",
  "country_code": "CH",
  "country_bounds": [
    5.95538,
    45.818852,
    10.490936,
    47.809357
  ],
  "country_languages": [
    "de",
    "fr",
    "it"
  ],
  "continent": "Europe",
  "continent_code": "EU",
  "city": "Zurich",
  "latitude": 47.36667,
  "longitude": 8.55,
  "postal": "8000",
  "region": "Zurich",
  "region_code": "ZH",
  "timezone": "Europe/Zurich",
  "elevation": 433
}

Changes

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