周辺検索を使う方法
概要
- テキスト検索と違って、リクエストは1回分で済む
- 並べ替えができる
nameパラメータを指定する
- エイリアスを含めたプレイス名を検索
- 半角・全角を厳密に識別するため、実用性は微妙
keywordパラメータを指定する
- 名前、タイプ、住所とユーザのクチコミや第三者のコンテンツも対象となる
- 半角・全角も同一視してくれるため、使うならこっち
実験
- 緯度経度、radiusの最大値50,000mの範囲外だと、検索結果は0件になる
-
rankby=distanceとすると、radiusが強制的に50kmとなる。条件的には上記と同様であるが、50kmの範囲内で該当するものを返す。ただし、この結果は無理矢理返しているような内容になる（例えば、大阪市内で「青森」と検索すると、[近畿青森県人会, 青森放送 大阪支社]などが結果として返される） - あくまで緯度経度ありきでの検索になる模様
テキスト検索を使う方法
概要
- 緯度経度情報は不要
- 「東京 ラーメン」という具合にフリーワード検索ができる
- この文字列に一致した候補を、関連性の高い順で返す
- リクエストの消費回数は10回分となるので、使い過ぎには注意
- 並び替えはできない
location, radiusパラメータを指定したとき
- 範囲内の結果は、範囲外のものよりも優先して返す
- 知名度が高い場合、範囲外であっても結果に含まれる可能性がある
実験
- 緯度経度を指定し、指定範囲から大きく外れた場所（例えば、大阪の緯度経度で「北海道 ゴルフクラブ」など）を検索文字列として渡した場合、恐らく、該当がないなどの理由で緯度経度・範囲指定を無視し、通常のテキスト検索が行われる模様
- 期待される検索キーワードが「大阪 ラーメン」や「ラーメン」といった地名+αになっているせいか、地名のみの検索には極端に弱い模様（この仕様はGoogle Mapsと同じ）