Updated on Sat, 2012-08-25 13:28

Places are specific, named locations with corresponding geo coordinates. They can be attached to Tweets by specifying a place_id when tweeting. Tweets associated with places are not necessarily issued from that location but could also potentially be about that location. Places can be created and searched for. Tweets can also be found by place_id. See About Geo Place Attributes for more information.


Field Guide

Consumers of Places should tolerate the addition of new fields and variance in ordering of fields with ease. Not all fields appear in all contexts. It is generally safe to consider a nulled field, an empty set, and the absence of a field as the same thing.

Field Type Description
attributes Object Contains a hash of variant information about the place. See About Geo Place Attributes.


"attributes": {
    "street_address": "795 Folsom St",
    "623:id": "210176",
    "twitter": "twitter"
bounding_box Object A bounding box of coordinates which encloses this place.


"bounding_box":{"coordinates":[ [ [2.2241006,48.8155414], [2.4699099,48.8155414], [2.4699099,48.9021461], [2.2241006,48.9021461] ] ], "type":"Polygon"}

country String Name of the country containing this place.



country_code String Shortened country code representing the country containing this place.



full_name String Full human-readable representation of the place's name.


"full_name":"Paris, Paris"

id String ID representing this place. Note that this is represented as a string, not an integer.



name String Short human-readable representation of the place's name.



place_type String The type of location represented by this place.



url String URL representing the location of additional place metadata for this place.



Bounding box

Field Type Description
coordinates Array of Array of Array of Float A series of longitude and latitude points, defining a box which will contain the Place entity this bounding box is related to. Each point is an array in the form of [longitude, latitude]. Points are grouped into an array per bounding box. Bounding box arrays are wrapped in one additional array to be compatible with the polygon notation.


"coordinates":[ [ [2.2241006,48.8155414], [2.4699099,48.8155414], [2.4699099,48.9021461], [2.2241006,48.9021461] ] ]

type String The type of data encoded in the coordinates property. This will be "Polygon" for bounding boxes.