Places

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

XML Schema:

Resource Defintion

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-time.
date_last_modified Datetime The time when the resource was last modified, in the standard dates-time.

Get a Place

GET /places/(string: place_id)

List Places

GET /places