koogawa blog

iOS、Android、foursquareに関する話題

ベニュー検索API venues/search に near パラメータ追加

これまで、ベニュー検索時には ll パラメータ(緯度・経度)で位置を指定するのが普通でしたが、これに加え near での指定も可能になりました。

Search Venues
https://developer.foursquare.com/docs/venues/search

near には "Chicago, IL"、"渋谷駅" といった geocodable な文字列が指定できるようです。

ベニュー検索時には ll, near のとちらかが必須で、両方指定した場合は near が優先されるようです。

レスポンスに geocode オブジェクトも返ってくる

near でベニュー検索すると、レスポンスに geocode というオブジェクトが返ってきます。このオブジェクトには near に指定した文字列にマッチした位置情報が含まれるようです。

Geocode Response
https://developer.foursquare.com/docs/responses/geocode

"near=渋谷駅" で検索した結果 (geocode以外の項目は省略してます)

ちなみに、near に geocodable でない文字列を指定した場合は、failed_geocode が返ってくるようです。