IPGeolocation.io · JSON Structure

Timezone Location Structure

Geolocation information associated with the requested IP address or location query. This object appears when the timezone lookup is performed using the `ip` or `location` parameters. It provides geographic details such as continent, country, administrative regions, and coordinates used to determine the corresponding timezone.

Type: object Properties: 16

GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Location is a JSON Structure definition published by IPGeolocation.io, describing 16 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

location_string continent_code continent_name country_code2 country_code3 country_name country_name_official is_eu state_prov state_code district city locality zipcode latitude longitude

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-structure/timezone-location-structure.json",
  "name": "Location",
  "description": "Geolocation information associated with the requested IP address\nor location query.\n\nThis object appears when the timezone lookup is performed using\nthe `ip` or `location` parameters.\n\nIt provides geographic details such as continent, country,\nadministrative regions, and coordinates used to determine the\ncorresponding timezone.\n",
  "type": "object",
  "properties": {
    "location_string": {
      "type": "string",
      "description": "Original location string provided in the request.",
      "example": "London, UK"
    },
    "continent_code": {
      "type": "string",
      "description": "Two-letter continent code.",
      "example": "EU"
    },
    "continent_name": {
      "type": "string",
      "description": "Full name of the continent.",
      "example": "Europe"
    },
    "country_code2": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code.",
      "example": "GB"
    },
    "country_code3": {
      "type": "string",
      "description": "ISO 3166-1 alpha-3 country code.",
      "example": "GBR"
    },
    "country_name": {
      "type": "string",
      "description": "Common name of the country.",
      "example": "United Kingdom"
    },
    "country_name_official": {
      "type": "string",
      "description": "Official name of the country.",
      "example": "United Kingdom of Great Britain and Northern Ireland"
    },
    "is_eu": {
      "type": "boolean",
      "description": "Indicates whether the country is a member of the European Union."
    },
    "state_prov": {
      "type": "string",
      "description": "State, province, or region name.",
      "example": "England"
    },
    "state_code": {
      "type": "string",
      "description": "Standardized state or region code.",
      "example": "GB-ENG"
    },
    "district": {
      "type": "string",
      "description": "District or administrative subdivision.",
      "example": "Greater London"
    },
    "city": {
      "type": "string",
      "description": "City name of the location.",
      "example": "London"
    },
    "locality": {
      "type": "string",
      "description": "Smaller locality or neighborhood within the city.",
      "example": "Westminster"
    },
    "zipcode": {
      "type": "string",
      "description": "ZIP or postal code of the location.",
      "example": "SW1A"
    },
    "latitude": {
      "type": "string",
      "description": "Latitude coordinate of the location.",
      "example": "51.50002"
    },
    "longitude": {
      "type": "string",
      "description": "Longitude coordinate of the location.",
      "example": "-0.19244"
    }
  }
}