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 マップのリンク | 説明 | フィールド名 |
|---|---|---|
| 場所 | Google マップで場所を開くためのリンク。 | googleMapsLinks.placeUri |
| ルート | Google マップでその場所への経路を開くためのリンク。 | googleMapsLinks.directionsUri |
| クチコミを書く | Google マップでその場所のクチコミを投稿するためのリンク。 | googleMapsLinks.writeAReviewUri |
| レビューを表示 | 場所の Google マップのクチコミを表示するリンク。 | googleMapsLinks.reviewsUri |
| 写真 | Google マップで場所の写真を表示するためのリンク。 | googleMapsLinks.photosUri |
Places レスポンスにすべてのリンクを含める
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 オプションに慣れることができます。
ページの右側にある API アイコンを選択します。
必要に応じて、[標準パラメータを表示] を開き、
fieldsパラメータをフィールド マスクに設定します。必要に応じて、[リクエスト本文] を編集します。
[Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。
API Explorer パネルで を選択します。
[全画面表示] をクリックすると、API Explorer ウィンドウが拡大されます。