IPGeolocation.io · JSON Structure

Astronomy Location Structure

Geolocation information associated with the resolved location. For coordinate-based or location-string lookups, only basic geographic fields are returned (latitude, longitude, country, state, city, locality, elevation). For IP-based lookups, extended fields are also returned including continent codes, country codes, district, zipcode, and other metadata.

Type: object Properties: 17
GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

Location is a JSON Structure definition published by IPGeolocation.io, describing 17 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 elevation

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

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-structure/astronomy-location-structure.json",
  "name": "Location",
  "description": "Geolocation information associated with the resolved location.\n\nFor coordinate-based or location-string lookups, only basic geographic\nfields are returned (latitude, longitude, country, state, city, locality,\nelevation).\n\nFor IP-based lookups, extended fields are also returned including\ncontinent codes, country codes, district, zipcode, and other metadata.\n",
  "type": "object",
  "properties": {
    "location_string": {
      "type": "string",
      "description": "The location string provided in the request. Only present when the\n`location` query parameter was used.\n",
      "example": "New York, USA"
    },
    "continent_code": {
      "type": "string",
      "description": "Two-letter continent code. Returned for IP-based lookups only.",
      "example": "NA"
    },
    "continent_name": {
      "type": "string",
      "description": "Full name of the continent. Returned for IP-based lookups only.",
      "example": "North America"
    },
    "country_code2": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code. Returned for IP-based lookups only.\n",
      "example": "US"
    },
    "country_code3": {
      "type": "string",
      "description": "ISO 3166-1 alpha-3 country code. Returned for IP-based lookups only.\n",
      "example": "USA"
    },
    "country_name": {
      "type": "string",
      "description": "Common name of the country.",
      "example": "United States"
    },
    "country_name_official": {
      "type": "string",
      "description": "Official name of the country. Returned for IP-based lookups only.\n",
      "example": "United States of America"
    },
    "is_eu": {
      "type": "boolean",
      "description": "Indicates whether the country is a member of the European Union.\nReturned for IP-based lookups only.\n"
    },
    "state_prov": {
      "type": "string",
      "description": "State, province, or region name.",
      "example": "New York"
    },
    "state_code": {
      "type": "string",
      "description": "Standardized state or region code. Returned for IP-based lookups only.\n",
      "example": "US-NY"
    },
    "district": {
      "type": "string",
      "description": "District or administrative subdivision. Returned for IP-based\nlookups only.\n",
      "example": "Manhattan"
    },
    "city": {
      "type": "string",
      "description": "City name of the location.",
      "example": "New York"
    },
    "locality": {
      "type": "string",
      "description": "Smaller locality or neighborhood within the city.",
      "example": "Midtown West"
    },
    "zipcode": {
      "type": "string",
      "description": "ZIP or postal code of the location. Returned for IP-based\nlookups only.\n",
      "example": "10001"
    },
    "latitude": {
      "type": "string",
      "format": "float",
      "description": "Latitude coordinate of the resolved location.",
      "example": "40.76473"
    },
    "longitude": {
      "type": "string",
      "format": "float",
      "description": "Longitude coordinate of the resolved location.",
      "example": "-74.00084"
    },
    "elevation": {
      "type": "string",
      "description": "Elevation above sea level at the location, in meters.",
      "example": "9"
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/astronomy-location-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.