Places

A place is a concrete geographical feature, location or area on the Earth.

XML Schema:

Resource Definition

Note

This resource can be searched, allowing to you to access a filtered set of data. See our Searching The G API documentation for details on how to query specific fields and the operators available.

Fields

Name

Type

Description

id (read-only)

String

href (read-only)

Field

name (required)

String

country (read-only)

Reference Object

state (read-only)

Reference Object

latitude (required)

Decimal

A geographic coordinate that specifies the north-south position of a point on the Earth’s surface (valid values range from -90.0 to 90.0)

longitude (required)

Decimal

A geographic coordinate that specifies the east-west position of a point on the Earth’s surface (valid values range from -180.0 to 180.0)

population (read-only)

Integer

elevation (read-only)

Integer

In meters

ascii_name (read-only)

String

The name of this resource in plain ascii characters

alternate_names (read-only)

Field

Additional names for the place. This includes the name in other languages.

bounding_box (read-only)

Field

A set of geographic coordinates that represents the minimum bounding box that covers the extent of a place. The box will be defined by [xmin, ymin, xmax, ymax].

feature (read-only)

Nested Object

The type of place

  • id (read-only)

String

  • href (read-only)

Field

  • name (required)

String

The name of this feature

  • code (required)

String

  • description (required)

String

  • feature_category (required)

Nested Object

    • id (read-only)

String

    • href (read-only)

Field

    • code (required)

String

    • description (required)

String

timezone (read-only)

Nested Object

  • id (read-only)

String

  • href (read-only)

Field

  • code (required)

String

  • gmt_offset (required)

String

  • dst_offset (required)

String

place_dossier (read-only)

Reference Object

places_of_interest (read-only)

Field

admin_divisions (read-only)

Field

  • id (read-only)

String

  • href (read-only)

Field

  • name (required)

String

  • feature (read-only)

Reference Object

  • state (read-only)

Reference Object

  • country (read-only)

Reference Object

dossier_frequency (read-only)

Integer

How many dossiers reference this place

date_created

Datetime

The time when the resource was created, in the standard Dates & Times.

date_last_modified

Datetime

The time when the resource was last modified, in the standard Dates & Times.

Get a Place

GET /places/(string: place_id)

List Places

GET /places