This guide provides reference information and URI examples
for the Yahoo! PlaceFinder Web Service.
This guide is intended for software developers who have prior
experience with REST Web services.
Yahoo! PlaceFinder is a REST Web service that
supports world-wide geocoding of street addresses, points of interest, airports, and place names.
Points of interest are locations such as schools, shopping malls, museums, and transit stations. Place names supported include
counties, states, countries, and continents.
To access the PlaceFinder Web service, call HTTP GET on the
specifying the input location with one or more URI parameters.
The response from PlaceFinder
geographic data, including latitude and longitude, as well
as address information such as street, state, and country.
PlaceFinder supports the following type of queries:
Single-line address: An address contained in a single field. The Web service parses the address data and return the best
Multi-line address: An address contained in up to three boxes. The Web service combines the address data and then processes
it like a single-line address query.
Fully parsed address: An address with each component (street, city, etc.) is in a separate field. The Web service does
not parse the address, so it is less likely to
interpret the address incorrectly, such as
mistaking a street name for a city name.
Point of Interest (POI), Area of Interest (AOI): Places not identified by mailing addresses, such as parks and monuments.
Airport codes: The three-letter airport codes you may have seen printed on your luggage tags.
Where On Earth ID (WOEID): A unique permanent identifier of a location.
Coordinates: The latitude and longitude of a location. Sometimes called reverse geocoding, this feature enables applications
to get the address nearest to the specified coordinates.