q filter country code

The optional country code follows the ISO 3166-1 Alpha-2 specification for country codes. Note that using a country focus may not significantly alter the order of highly probable results. Queries for London, Paris, Rome will always return "London, GB", "Paris, FR", "Rome, IT" over similarly named places in other countries.

If you want to limit results to a specific country, you will need to filter the results yourself. We are considering an enhancement to the .q filter that would provide this capability.

Eddie Babcock
Yahoo! Geo Technologies

Could you post an example of how to use the "filter by country" example?

If i try http://where.yahooapis.com/v1/places$and(....n&appid=XXX

I get México as a country, not Córdoba city in México.

Thanks!!

The .q filter accepts a second parameter containing an ISO country code. Results matching the first parameter that are in that country will have their probabilities adjusted upward, making them more likely to be returned at or near the top of the the results list. Here is how you use the focus parameter:

This returns 16 results, with the ones in Mexico at the top.

Note that this is different than including the country code in the first parameter, which will not return places in other countries if any places are found in the country:

This returns 2 results. Note the quotes around the query string.

This returns 16 results because there is no place named Cordoba in Japan.

In order to distinguish between places having the same name, you may need to provide additional information in the query string. For example, if you want the Cordoba in Durango State, Mexico, you would need to include the state name the query string:

This returns 1 result.

Eddie Babcock
Yahoo! Geo Technologies