Google Maps Reviews
Google Mapsの口コミは、スポットに対する公開フィードバックのレコードで、本文、投稿者の参照、評価、元リンクと対象スポットのリンク、公開日時と取得日時、メディアを含む場合があります。出典に紐付いたフィードバックのデータセット作成や、既知のスポット間・取得期間ごとの比較に活用できます。
Google Maps Reviews API の主な機能
- 既知のURLを一括入力別の識別子APIでスポットを解決する代わりに、対応する google.com または goo.gl のURLを1つ以上、1つの非同期タスクで送信できます。
- 任意の日数ウィンドウ直近の口コミに絞りたい場合は、正の値の days_limit を1つ指定すると、送信したすべてのURL行に適用されます。
- 安定した口コミレコード口コミの識別情報、本文、投稿者フィールド、評価、スポットの参照、タイムスタンプ、元URL、取得可能なメディアを review v1.0 スキーマで読み取れます。
Google Maps Reviews API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | google.com、google.com の任意のサブドメイン、goo.gl、または goo.gl のサブドメイン上にある空でないURLを1つ以上、カンマまたは改行で区切って指定します。口コミの取得には既知のマップのスポットURLを使用してください。 |
days_limit | 任意 | 任意。口コミの期間ウィンドウとして、プロバイダーへのすべての入力行に適用される正の整数です。省略すると日数による期間フィルターは送信されません。 |
results_limit | 任意 | 任意。タスクで保存する口コミの合計件数の上限で、1〜2,000の整数を指定します。デフォルトは100で、ソース側の状況によって件数が少なくなることがあります。 |
Google Maps Reviews API の使い方
既知のGoogle Maps URLを送信して非同期タスクを追跡し、保存された口コミレコードをタスク結果のカーソルで読み取ります。
- google.com または goo.gl 上の、対応するGoogle MapsスポットURLを1つ以上用意します。
- urls と、必要に応じて days_limit と results_limit を /v1/google-maps/reviews に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /v1/tasks/{task_id}?limit=50 を読み取り、results.has_more が true の間は results.next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
-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"],"days_limit":3650,"results_limit":3}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Google Maps Reviews API の主なユースケース
- 既知スポットのフィードバックデータセット: 指定した公開スポットURLのセットについて、口コミ本文、評価、公開日時、元リンクを整備します。
- 出典を意識した投稿者リサーチ: 取得可能な投稿者名、ユーザー名、プロフィールリンク、口コミURLを保持し、各レコードを公開時の文脈までさかのぼれるようにします。
- 直近期間の比較: 同じスポットのセットを、記録した days_limit の値で時期を変えて実行し、全履歴であるとは主張せずに、範囲を区切った取得結果同士を比較します。
- メディア付き口コミのアーカイブ: 取得可能な口コミのメディアを、本文、評価、スポットの参照、取得時刻とあわせて正規化されたリサーチ用レコードに保持します。
Google Maps Reviews API 活用のヒント
- 解決可能な google.com または goo.gl のマップURLを送信してください。スポット名、Googleビジネスプロフィールのアカウント、Place IDのみでは urls の項目として受け付けられません。
- days_limit は、正の整数による期間指定に意味がある場合にのみ使用してください。省略すると、プロバイダーへの入力行にそのフィルターは設定されません。
- results_limit はURLごとの保証件数ではなく、URLバッチ全体で保存される結果の上限として扱ってください。
- 送信時の results_limit と、タスク読み取り時の limit は区別してください。後者は1〜500の範囲でページサイズを制御し、不透明なカーソルを使用します。
- 公開ソースで公開されていない場合、本文、投稿者の属性、評価、対象スポットの参照、タイムスタンプ、メディアが欠けることを想定してください。
関連API
Google Maps Reviews API 以外に別の種類の公開Google Mapsデータが必要な場合は、これらのAPIをご利用ください。
- Google Maps Search API — クエリと場所で公開Google Mapsのスポットを検索し、正規化された名称・ID、住所、連絡先、評価、レビュー数、URL、座標の各フィールドを返します。
- Google Maps Place Details API