hi bob. "soon" :P
On Fri, Mar 26, 2010 at 2:06 PM, bob.hitching <b...@hitching.net> wrote: > good stuff raffi, any further news on if/when the new <place> data > will be exposed via the Search API? > > cheers, bob > > GeoMeme - http://www.geome.me - what's happening where? > > On Mar 2, 12:44 pm, Raffi Krikorian <ra...@twitter.com> wrote: > > hi all. > > > > i wanted to give you all a heads up on some big changes we're making to > our > > geo-tagging API. right now, you can post a status update along with a > > latitude and longitude pair -- what we've jokingly referred to as > > "geo-tweeting", is actually just a status update with a "where" in the > form > > of a coordinate attached to it. we're about to add a whole new layer of > > context to that status update. > > > > our goal is to provide a few more options to API developers (and the > users > > they are servicing) through this contextual information. people, we > find, > > inherently want to talk about a "place". a place, for a lot of people, > has > > a name and is not a latitude and longitude pair. (37.78215, -122.40060), > > for example, doesn't mean a lot to a lot of people -- but, "San > Francisco, > > CA, USA" does. we're also trying to help users who aren't comfortable > > annotating their tweets with their exact coordinates, but, instead, are > > really happy to say what city, or even neighborhood, they are in. > > annotating your place with a name does that too. > > > > once our new additions to our geo infrastructure comes into place, > > geo-tweets will get richer data. for example, a status object may look > like > > the following (abbreviated): > > > > { > > "id":9505317221, > > ... > > "coordinates": { > > "type":"Point", > > "coordinates": [-122.40060, 37.78215] > > }, > > "place": { > > "country":"United States", > > "country_code":"US", > > "full_name":"SoMa, San Francisco", > > "name":"SoMa", > > "place_type":"neighborhood", > > "bounding_box": { > > "type":"Polygon", > > "coordinates": [ > > [ > > [ -122.42284884, 37.76893497 ], > > [ -122.3964, 37.76893497 ], > > [ -122.3964, 37.78752897 ], > > [ -122.42284884, 37.78752897 ] > > ] > > ] > > }, > > "id":"7695dd2ec2f86f2b", > > "url":"/1/geo/id/7695dd2ec2f86f2b.json" > > }, > > ... > > "text":"Wherever you go, there you are." > > > > } > > > > here you'll see a new place attribute that gives the contextual location > of > > the geo-tweet itself. in these cases, you'll have rich, and > human-readable, > > information about where this tweet has come from -- in this case, SoMa, > San > > Francisco. the geo object, for the time being, is still there, so you > don't > > have to worry about backwards compatibility. it will soon be deprecated, > > however and please plan for that. we're also introducing a > > coordinatesobject which has the added bonus that, when in JSON, it is > > properly GeoJSON > > encoded with the longitude before latitude. > > > > to support this these changes we've added a few endpoints: > > > > > https://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-geo-revers...https://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-geo-ID > > > > you can call geo/reverse_geocode with a latitude and longitude, and it > will > > return an array of places that you can use to annotate your tweet with. > > each place that is returned will have a unique ID that you can use, as > well > > as a displayable name, and even a geographical bounding box that you can > use > > for display on a map. if you want more details, then hit the > > geo/idendpoint where, if available, and if you're interested, you can > > retrieve a > > more detailed geometry for more accurate map drawing. we've also updated > > the statuses/update documentation ( > https://apiwiki.twitter.com/Twitter-REST-API-Method%3A-statuses%C2%A0...) > > to indicate how to pass that place ID with your status update. > > > > for this first pass, we're only going live with United States-centric > data, > > but that will quickly be expanded geographically as we work out the kinks > in > > our system. there are definitely some nuances that i'm missing in this > > e-mail, a few things are still in flux, but we're rapidly documenting > this > > on our wiki, and we hope to be going live with it quite soon. as always, > if > > you have any questions, just find us at @twitterapi, or drop us an > e-mail. > > > > -- > > Raffi Krikorian > > Twitter Platform Teamhttp://twitter.com/raffi > > To unsubscribe from this group, send email to twitter-development-talk+ > unsubscribegooglegroups.com or reply to this email with the words "REMOVE > ME" as the subject. > -- Raffi Krikorian Twitter Platform Team http://twitter.com/raffi To unsubscribe from this group, send email to twitter-development-talk+unsubscribegooglegroups.com or reply to this email with the words "REMOVE ME" as the subject.