Hi there,
Could someone please add a country parameter or bounding box parameter to the Yahoo placefinder API? I tried the parameter &country=za but for some reason the API still seems to think Pretoria is somewhere in the United States. Otherwise please add a place where we can specify a bounding box for the API to search in ? (I am not talking about the returned bounding box values)
If this does already exists could you please update your help/support documentation so that we can see how to use it?
It would be helpful if you provided an example request. A simple test using the following request returns one result for Pretoria in South Africa:
CODE
http://where.yahooapis.com/geocode?q=Pretoria&appid=...
Placefinder offers users three ways to specify an input address: single-line, multi-line, and parsed input. Single-line input uses the q parameter to pass the entire input address, including any punctuation. Multi-line input uses the line1, line2, line3 parameters to pass the input address as several lines (similar to how addresses are written on envelopes); for example, line1 can be used for the house number and street name, line2 can be used for the city, state, and postal code, and line3 can be used for the country. Parsed input uses the house, street, unittype, unit, city, state, postal, and country parameters to pass the components of the input address. For example, the address for the White House would be passed as house=1600, street=Pennsylvania Ave NW, city=Washington, state=DC, postal=20006, country=US. You can omit parameters if you don't have the data, such as postal and country, but the more data you provide, the better the result will be.
Users can also boost the ranking of results within a specific country by passing the locale parameter. The locale parameter specifies the desired language for the results and the country focus using the format ll_CC, where ll is an ISO 639 2-letter language code and CC is an ISO 3166-1 2-letter country code. For example, to boost results for places in South Africa, you would pass locale=en_ZA. Using a country focus may not ensure that a place in that country is ranking first; there may be a more important place in a different country that is ranked higher.
Eddie Babcock
Yahoo! Geo Technologies
