このページは Cloud Translation API によって翻訳されました。

Google マップへのリンク

Places API は、さまざまな方法で場所データのリクエストを受け入れます。Places API レスポンスには、位置データや画像、地理的位置、注目のスポットなど、場所に関するデータが含まれます。

今回のリリースでは、テキスト検索、周辺検索、場所の詳細のレスポンスに Google マップのリンクを含めることもできます。ユーザーはこれらの Google マップのリンクにアクセスして、レスポンス内の場所に関する追加情報を確認できます。

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

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

Reviews.googleMapsUri: レビューへの Google マップのリンクが含まれており、ブラウザで確認できます。
Photos.googleMapsUri: 写真への Google マップのリンクが含まれており、ブラウザで表示できます。

API Explorer では、ライブリクエストを実行して、次の新しいオプションをご確認ください。

試してみる

場所でサポートされている Google マップのリンク

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

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

料金

この機能は一般提供前のプレビュー段階にあり、プレビュー期間中の使用料金は発生しません（請求額は 0 ドル）。提案されている料金の詳細については、Places API の使用と課金をご覧ください。

プレイスレスポンスにすべてのリンクを含める

プレイスレスポンスのリンクは 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 メソッドは、レスポンスでの経路リンクの生成をサポートしています。現在地が起点として使用され、場所の位置が目的地として使用され、移動モードはドライブです。

次の例では、近くの検索を使用して、レスポンスの 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 オプションを把握できます。

ページの右側にある API アイコンを選択します。
必要に応じて [標準パラメータを表示] を開き、fields パラメータをフィールドマスクに設定します。
必要に応じて、[リクエスト本文] を編集します。
[Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。
API Explorer パネルで展開アイコンを選択して、API Explorer ウィンドウを開きます。