google-maps/
place-details

既知の公開Google Maps URLから詳細情報を取得し、スポットの識別情報、カテゴリ、住所、連絡先、評価、口コミ数、Webサイト、地理情報を正規化して返します。

Google Maps Place Details API

既知のマップURL
スポットの詳細
正規化された場所データ
結果1件あたり0.15クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Google Maps Place Details

Google Mapsの公開スポットページでは、名称、カテゴリ、説明、住所、連絡先、評価、口コミ数、Webサイト、地理情報が公開されている場合があります。正規化されたレコードにより、これらの表示中のフィールドを拠点リスト、施設リサーチ、ディレクトリの情報補完、特定時点のモニタリングと簡単に結び付けられます。

Google Maps Place Details API の主な機能

  • URLの一括詳細取得1つ以上の既知のGoogle Maps URLを送信すると、空でない入力ごとにプロバイダーの詳細取得行が1行作成されます。取得件数の上限は、送信したURLの数に内部で設定されます。
  • 安定したスポットレコード識別情報、元URL、名称、説明、カテゴリ、住所、電話番号、Webサイト、評価、口コミ数を PlaceItem スキーマで返します。
  • 構造化された地理情報取得可能な所在地名、市区町村、地域、国、緯度、経度を、表示用テキストから解析することなくまとめて保持します。
  • 結果に応じた課金送信したURL1件につき0.15クレジットで見積もり、正常に返された標準スポットレコード1件につき0.15クレジットで精算します。結果が空の場合は課金されません。

Google Maps Place Details API のパラメータ

パラメータ必須説明
urls必須必須。パーサーがホスト名を取得できる参照の空でない配列です。ランタイムはホスト名で google.com、goo.gl、およびそれらのサブドメインを受け付けます。オーソリティ部分を含む任意のスキームとプロトコル相対参照を受け付け、特定のパスパターンは必要ありません。

Google Maps Place Details API の使い方

既知のGoogle Maps URLを送信して非同期タスクを追跡し、保存されたすべての PlaceItem を標準のカーソル付き結果エンベロープで読み取ります。

  1. 解析後のホスト名が google.com、goo.gl、またはそのいずれかのサブドメインになる参照を1つ以上用意します。
  2. urls を /v1/google-maps/place-details に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor をたどります。送信リクエスト自体には results_limit フィールドはありません。
curl -X POST "https://api.socq.ai/v1/google-maps/place-details" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Google Maps Place Details API の主なユースケース

  • 拠点ディレクトリの情報補完: 既知のスポットURLに、正規化されたカテゴリ、住所、電話番号、Webサイト、評価、口コミ数、座標のフィールドを追加します。
  • 店舗・支店の監査: 管理しているURLリストを定期的に再取得し、表示中の識別情報、連絡先、評価、地理情報を所定の取得時点で比較します。
  • スポットレコードの照合: 返されたID、元URL、名称、住所、座標を使い、公開スポットを社内の拠点レコードと突き合わせます。

Google Maps Place Details API 活用のヒント

  • パーサーが受け付け可能なホスト名を解決できるよう、完全な絶対URL形式のマップURLを送信してください。スキームのないホスト名だけでは、ランタイムのパーサーでホスト名を取得できません。
  • Place ID、Google APIキー、フィールドマスク、results_limit は、このSocQのリクエスト仕様に含まれないフィールドのため追加しないでください。
  • 送信した各URLは結果が保証されたものではなく、詳細取得の候補として扱ってください。ソース側の行が利用できない、または使用できない場合、項目数がURL数より少なくなることがあります。
  • null になり得る電話番号、Webサイト、評価、口コミ数、説明、公開日時、所在地の各項目は、代替値を補わずそのまま保持してください。
  • プロバイダー側の上限はURLの数で決まりますが、保存されたタスク結果の読み取りにはページネーションが適用されるため、has_more が true の間は next_cursor で続きを取得してください。

Google Maps Place Details API 以外に別の種類の公開Google Mapsデータが必要な場合は、これらのAPIをご利用ください。

  • Google Maps Search API — クエリと場所で公開Google Mapsのスポットを検索し、正規化された名称・ID、住所、連絡先、評価、レビュー数、URL、座標の各フィールドを返します。
  • Google Maps Reviews API

他のプラットフォームを見る

Google Mapsのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Google Maps Place Details API — よくある質問

Google Maps Place Details APIは、既知の公開Google Maps URLを正規化された PlaceItem レコードに変換します。取得可能な識別情報、カテゴリ、連絡先、評価、口コミ数、住所、Webサイト、所在地のフィールドを返します。

解析後のホスト名が google.com、goo.gl、またはそのいずれかのサブドメインになる参照を送信してください。オーソリティとホスト名があれば任意のスキームを受け付け、プロトコル相対参照も使用できます。特定の /maps/place パスは必要ありません。

呼び出しません。リクエストはSocQ経由で既知の公開Google Maps URLを受け付けるもので、公式のPlace ID、Google APIキー、OAuth認証情報、フィールドマスクは受け付けません。

指定できません。プロバイダーへの入力は空でないURLごとに1行の詳細取得行で構成され、内部の上限はその行数と同じになります。results_limit は公開されているリクエストフィールドではありません。

元のURLが利用できない、エラー行が返される、または利用可能な正規化スポットを生成できない場合があるためです。送信した他のURLは、それぞれ独立して処理が続行されます。

GET /v1/tasks/{task_id} をポーリングし、成功後に data.results.items を読み取ります。has_more が true の間は next_cursor を使って次のページを取得してください。

見積もりは、送信した空でないURL1件につき0.15 SocQクレジットです。最終的な課金は、正常に返された標準スポットレコード1件につき0.15クレジットで、結果が空の場合は0クレジットです。