ローカルビジネスと場所のための Maps API
POST /maps に検索語（必要に応じて座標）を送ると、Google Maps の 1 ページ分、最大 20 件の場所が構造化 JSON で返ります。
エンドポイント
「coffee shops」のような検索語と、必要に応じて地図上の地点を送るだけ。1 ページ分の場所が構造化 JSON で返り、そのまま絞り込み、地図表示、エージェントへの受け渡しに使えます。
名前、place ID、マップリンク、住所、電話、Web サイト。
評価、レビュー数、営業時間、現在の営業状況。
緯度・経度・ズームで検索範囲を指定。
活用例
営業リスト作成 / 店舗検索 / エージェントの旅行計画
スクレイパーを作らずに Google Maps の結果を取得
マップのページは人が見るためのもので、プログラムからデータを集めるのは大変です。Maps endpoint は各場所の名前、place ID、公開 Google Maps リンクに加え、Google Maps に表示されている場合は住所、電話番号、Web サイト、カテゴリ、評価、レビュー数、座標、営業時間、価格帯を返します。取得できない項目は省略されるため、プレースホルダー値を解析する必要はありません。
構造化された場所データ
各場所に名前、place ID、マップリンクが含まれ、取得できる場合は住所、電話番号、Web サイト、カテゴリ、評価、レビュー数、座標、営業時間も返します。
地点周辺を検索
緯度、経度、ズームを指定して地点周辺を検索し、国と言語を設定してローカルな結果を取得できます。
1 ページ最大 20 件
1 リクエストで Google Maps の 1 ページ（最大 20 件）を返し、同じ地点を指定して次のページも取得できます。
ページ単位のシンプルな料金
完了した 1 ページにつき 3 クレジット（空のページを含む）。失敗したリクエストは課金されません。
Maps API とは？
Maps API は「渋谷 ラーメン」のようなマップ検索を、コードで扱える構造化データに変換します。Google Maps を開いて詳細を手で写す代わりに、検索語と任意の地点を送るだけで、連絡先、評価、座標付きの場所リストが返ります。Search1API は 1 リクエストで Google Maps の 1 ページを返すため、取得するページ数とコストを自分で決められます。
Maps API の料金
完了した各リクエストは Google Maps の 1 ページ（最大 20 件）を取得し、3 クレジットを消費します。結果が空と確認されたページも含みます。技術的な障害はエラーを返し、課金されません。max_results は返す件数を絞るだけで、料金は下がりません。新規アカウントには 100 無料クレジットが付与されます。
最大 20 件の 1 ページにつき 3 クレジット。
失敗したリクエストは課金なし。
1 つの検索で 1〜6 ページ。2 ページ目以降は地点の指定が必要。
新規登録で 100 無料クレジット、クレジットカード不要。
基本フロー
POST /maps に検索語（必要に応じて座標）を送ると、Google Maps の 1 ページ分、最大 20 件の場所が構造化 JSON で返ります。
検索語に国と言語を指定し、地点周辺を検索する場合は緯度、経度、ズームを追加します。
名前、マップリンク、Google Maps に表示される詳細を含む最大 20 件の場所を受け取ります。
さらに必要な場合は、同じクエリと地点で次のページをリクエストします。各ページは別リクエストです。
主な用途
Google Maps でローカルビジネスや場所を検索し、住所、電話番号、評価、座標、営業時間を構造化 JSON で取得
営業リスト：業種と都市でビジネスを集め、電話番号と Web サイトを取得。
住所、座標、営業時間が必要な店舗検索やローカルディレクトリ。
旅行計画、近くの候補の比較、「どこで…できる？」に答える AI エージェント。
FAQ
Maps API はどんなデータを返しますか？
すべての場所に順位、名前、place ID、公開 Google Maps リンクが含まれます。取得できる場合は住所、電話番号、Web サイト、サムネイル、カテゴリ、評価、レビュー数、座標、曜日ごとの営業時間、現在の営業状況、価格帯、短い説明も返します。
Maps API のクレジット消費は？
完了した 1 ページにつき 3 クレジットで、最大 20 件を含みます。結果が空と確認されたページも課金対象です。技術的な障害は課金されません。max_results を減らしても料金は下がりません。
特定の地点の周辺を検索するには？
latitude、longitude、任意の zoom（既定値 14）を含む location オブジェクトを渡します。location を指定しない場合は検索語から Google Maps が範囲を判断するため、「pizza in Brooklyn」のようなクエリも使えます。
20 件より多く取得するには？
同じ query、country、language、location で page を 2 以上（最大 6）にして次のページをリクエストします。2 ページ目以降は location が必要で、各ページは個別に課金されます。
Maps API と Search API の違いは？
Search は Web ページを返し、Maps は場所（住所、評価、座標付きのビジネスやスポット）を返します。ビジネスの Web サイトを読みたい場合は、続けて Crawl を使ってください。