Google マップへのリンク

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

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

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

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

  • 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. 必要に応じて [標準パラメータを表示] を展開し、the fields parameter を field mask に設定します。

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

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

  5. API Explorer パネルで、

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