開発者向けG Maps Crawl

Google Mapsデータ。
ワークフローに組み込む。

ビジネスを検索し、公開レビューを読み、場所の写真や動画を閲覧できます。同期型のREST APIで構築するか、MCP経由でAIアシスタントにアクセスを提供しましょう。

構造化JSON

同じレスポンスで結果を返却

REST + MCP

アプリケーションまたはAIクライアントから利用

1つのAPI利用枠

APIとMCPリクエストで共有

データを選ぶ

調査の各ステップに対応するAPI

まずビジネス検索から始め、場所のfeature IDを使ってレビューやギャラリー項目をリクエストします。各APIには独自のサンプルとフィールドリファレンスがあります。

初めてのAPIリクエスト

リクエストから構造化データへ

AuthorizationヘッダーでAPIキーを使用します。以下のリクエスト形式を確認し、クイックスタートに沿って最初の呼び出しを行ってください。

リクエスト例

完全な仕様については、APIドキュメントをご覧ください。

curl https://gmapscrawl.com/api/v1/search \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seattle-coffee-search-001" \
  -d '{"q":"coffee shops in Seattle","page":1,"extra":false}'

例示用の空のレスポンスです。ライブ検索では利用可能なビジネスが返ります。APIキーはサーバーサイドに保管し、新しい処理には新しい冪等キーを使い、変更しないリトライでは同じキーを保持してください。

レスポンス

例示用のJSON
{
  "data": {
    "total": 0,
    "params": {
      "q": "coffee shops in Seattle",
      "page": 1,
      "hl": "en",
      "extra": false
    },
    "businesses": []
  },
  "request_id": "req_example",
  "schema_version": "2026-09-22"
}

APIは同じレスポンス内でJSONを返します。タイムアウト後は、変更していないボディを同じIdempotency-Keyで再試行してください。テスト用認証情報では、実際の利用枠を消費せずにシミュレートされたデータが返ります。

標準的なHTTPで構築

小さな統合。役立つデータワークフロー。

01

APIキーを作成

APIワークスペースで認証情報を作成し、サーバーまたはクライアントのシークレット設定に保管します。RESTとMCPは同じAPI利用枠を共有します。

APIキーを開く
02

APIを選ぶ

キーワードと地域で検索します。レビューや写真には、お持ちのMaps feature IDを指定するか、検索結果からplace.dataIdを読み取ってください。

クイックスタートに進む
03

JSONレスポンスを読む

返されたページをアプリケーションで処理します。エンドポイントのページネーションルールに従い、欠損フィールドを確認し、リトライ用にリクエストの冪等キーを保持してください。

ページネーションを理解する

役立つものを作る

Mapsデータをアプリケーションに取り込む

返されたレコードを、独自の調査、レポート、社内ワークフローへの入力として使用します。

01

地域ビジネスの調査

カテゴリと地域で検索し、利用可能なビジネス名、住所、Webサイト、電話番号、評価をアプリケーションで整理します。

02

レビュー分析

場所の公開レビューを調べて顧客のフィードバックを分析します。一貫した並び順を選び、分析に必要なページを順に取得します。

03

場所ギャラリーの調査

場所で利用可能な写真・動画リンクを取得します。チームが元のコンテキストを確認できるよう、ソースのギャラリーリンクをレコードと一緒に保持します。

エージェントと接続

同じデータをAIクライアントで利用。

MCPサーバーに接続して検出可能なツールを利用するか、Agent Skillをインストールして再利用可能なワークフロー手順とRESTフォールバックを取得します。

接続したエージェントへのタスク例

「シアトルのコーヒーショップを1ページ分検索して。取得できた名前、Webサイト、評価を返して、欠損データを指摘して。」

リクエストはAPI利用枠を消費します。テスト用認証情報では、結果はシミュレートされます。

統合を計画する

スケール前に使用量を理解する

成功したライブページは、空のページを含め、1件につき1 APIリクエストを消費します。RESTとMCPはAPIプランを共有し、OnlineとExtensionの利用枠は別です。

リクエストを予測可能に保つ

まず1ページから始め、返されたフィールドを確認し、エンドポイントに適したクライアントタイムアウトを設定します。リトライ時は、変更していないリクエストボディで同じIdempotency-Keyを再利用してください。

プランの上限、レート制限、ソースの可用性、エンリッチメントはライブリクエストに影響します。テスト用認証情報は、ライブ利用枠を消費せずにシミュレートされたフィクスチャを返します。

リクエスト上限と結果フィールドについては各エンドポイントのページをご覧ください。料金ページには現在の付帯リクエスト数と有料の超過料金が記載されています。

よくある質問

どのGoogle Maps APIが利用できますか?

G Maps Crawlは、ビジネス検索、公開レビュー、場所の写真・ギャラリーAPIを提供しています。Searchはビジネスレコードを返し、ReviewsとPhotosはMaps feature IDを使って特定の場所の1ページを返します。

PythonやJavaScriptを使えますか?

はい。APIはHTTPリクエストとJSONを使用するため、Python、JavaScript、cURL、その他のHTTPクライアントから呼び出せます。各APIページにはリクエスト例とレスポンス例が含まれています。

ジョブ結果をポーリングする必要がありますか?

公開されているSearch、Reviews、Photos APIは、同じレスポンス内でJSONを返します。ジョブのポーリングやwebhookの設定は不要です。エンドポイントのタイムアウトとリトライのガイダンスに従ってください。

API、MCP、Agent Skillはどのように連携しますか?

RESTではアプリケーションからエンドポイントを直接呼び出せます。MCPは対応するAIクライアントにツールを提供します。Agent Skillはワークフロー手順とヘルパースクリプトを提供します。RESTとMCPのリクエストにはAPI認証情報が必要で、API利用枠を消費します。

レビューや写真用のfeature IDはどこで取得できますか?

お持ちのMaps feature IDを使うか、Search APIのdata.businesses配列内の一致するレコードからplace.dataIdをコピーします。その値をfidとしてReviewsまたはPhotos APIに渡します。

すべてのフィールドが必ず利用できますか?

いいえ。返されるフィールドはソースと選択したオペレーションによって異なります。データを使用する前に、欠損値と利用可能な観測タイムスタンプを確認してください。成功したレスポンスに空のページが含まれる場合があります。

次のステップへ

最初のGoogle Mapsデータワークフローを構築しましょう。

APIキーを作成し、1つのリクエストから始めて、アプリケーションで利用できるデータを確認してください。