GOOGLE_PLACES は、検索に対して Google 検索の「場所」タブが表示する場所のリストを返します。ローカルパックの下にある「その他の場所」から開くリストです。20件ずつ最大5ページを読み、すべてのページを同じ都市から検索するため、その都市で Google が並べた順に最大100件の場所を取得できます。都市全体のローカルリストでのビジネスの順位追跡や、ある都市で Google がサービスごとに表示するビジネスの収集に使ってください。
リクエスト
次のリクエストは、ロードアイランド州マンビルで長期介護施設を検索したときに Google が表示する場所を先頭から100件取得します。uule を保存しているシステムなら、city の代わりにその値を送ってください。次の値はネバダ州リノです。
limit: 100 のタスクは通常1〜2分で完了します。
パラメータ
city も uule も送らない場合は Google が検索地点を決めます。
レスポンス
たとえば、上のマンビルのリクエストの結果です。
後のページに再び出てきた場所は1回だけ数えます。
limit に届く前に Google のリストが終わると、places には Google が表示したすべての場所が入ります。小さな町では100件に満たないことがよくあります。Google が場所に表示しないフィールドは省略されます。name、position、page 以外はすべて任意フィールドとして扱ってください。
クレジット
読んだ場所ページごとに1クレジットです。送信時に、limit に必要なページ数(場所20件ごとに1ページ)のクレジットを確保します。既定値では1、limit: 100 では5です。完了時には実際に読んだページ数だけ課金するため、Google のリストが3ページで終われば3クレジットです。失敗したタスクは0です。クレジットと上限を参照してください。
制限とエラー
- 完了したタスクで
placesが空なら、その地点で Google がその検索に場所を1件も表示しなかったことを意味します。返す前に別のブラウザで再確認しており、1クレジットが課金されます。 - 1〜100の範囲外の
limit、空または100文字を超えるcity、uuleやlocationと一緒に送ったcityは422 VALIDATION_ERRORを返します。 w+形式の UULE でないuuleは400 VALIDATION_ERRORを返します。locationは422を返します。場所はcityまたはuuleで指定してください。include.rawResponseは効果がなく、include.htmlとinclude.analysisは422を返します。Markdownと生レスポンスを参照してください。- その他のリクエストエラーはエラーに記載しています。