Google マップへのリンク

Places API(新版)は、さまざまな方法で場所データのリクエストを受け付けます。Places API(新版)のレスポンスには、位置情報や画像、地理的位置、有名なスポットなど、場所に関するデータが含まれます。

テキスト検索(新版)、Nearby Search(新版)、Place Details(新版)からのレスポンスには、Google マップへのリンクが含まれることもあります。ユーザーは、これらの Google マップのリンクにアクセスして、回答内の場所に関する追加情報を確認できます。

たとえば、カリフォルニア州サンフランシスコの空港を検索するとします。レスポンスには、場所のリストにサンフランシスコ国際空港(SFO)が含まれます。レスポンスの SFO の Place オブジェクトに、Google マップを開くための Google マップのリンク、場所へのルート、場所のクチコミ、場所の写真を含む googleMapsUri フィールドが追加されます。

Place オブジェクトに追加されたリンクとともに、googleMapsUri フィールドもレスポンスの Reviews オブジェクトと Photos オブジェクトに追加されます。

  • Reviews.googleMapsUri: クチコミへの Google マップのリンクが含まれています。ブラウザで表示できます。

  • Photos.googleMapsUri: 写真への Google マップのリンクが含まれています。これにより、ブラウザで写真を表示できます。

API Explorer を使用すると、ライブ リクエストを実行して、これらの新しいオプションを理解できます。

試してみる

次の表に、レスポンスに含めることができる Google マップのリンクを示します。

Google マップのリンク 説明 フィールド名
場所 Google マップで場所を開くためのリンク。 googleMapsLinks.placeUri
ルート Google マップでその場所への経路を開くためのリンク。 googleMapsLinks.directionsUri
クチコミを書く Google マップでその場所のクチコミを投稿するためのリンク。 googleMapsLinks.writeAReviewUri
レビューを表示 場所の Google マップのクチコミを表示するリンク。 googleMapsLinks.reviewsUri
写真 Google マップで場所の写真を表示するためのリンク。 googleMapsLinks.photosUri

Places レスポンスのリンクは、googleMapsLinks フィールドに含まれています。レスポンスに表示する場合は、リクエストのフィールド マスクに googleMapsLinks フィールドを含めてください。

たとえば、次のテキスト検索(新版)では、レスポンスにすべてのマップのリンクが含まれます。

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

レスポンスの形式は次のとおりです。

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

レスポンスですべてのリンクを返す必要はありません。たとえば、レスポンスに写真のリンクのみを含める場合は、次のようにフィールド マスクを変更して、photosUri フィールドのみを含めます。

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

回答に道案内を含める

すべての Places メソッドは、レスポンスでのルート案内リンクの生成をサポートしています。現在地が出発地として使用され、場所の位置が目的地として使用されます。移動手段は車です。

次の例では、Nearby Search(新版)を使用して、directionsUri フィールドのレスポンスに地図のルートリンクを含めます。

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

このリリースでは、レスポンスの Reviews オブジェクトと Photos オブジェクトに googleMapsUri フィールドが追加されています。これらのリンクにアクセスすると、Google マップでクチコミまたは写真が開きます。

たとえば、次のテキスト検索(新版)では、レスポンスに各場所のクチコミと写真が含まれています。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

レスポンスでは、reviews 配列と photos 配列の各要素に googleMapsUri フィールドが含まれており、ブラウザでクチコミや写真を開くことができます。

試してみよう:

API Explorer を使用すると、サンプル リクエストを作成して、API と API オプションに慣れることができます。

  1. ページの右側にある API アイコンを選択します。

  2. 必要に応じて、[標準パラメータを表示] を開き、fields パラメータをフィールド マスクに設定します。

  3. 必要に応じて、[リクエスト本文] を編集します。

  4. [Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。

  5. API Explorer パネルで を選択します。

    [全画面表示] をクリックすると、API Explorer ウィンドウが拡大されます。