Google マップへのリンク

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

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

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

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

プレイス レスポンスのリンクは、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'

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

試してみよう:

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

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

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

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

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

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

    [全画面表示] をクリックして、API Explorer ウィンドウを拡大します。