Google 地圖連結

Places API (新版) 接受透過各種方法提出的地點資料要求。Places API (新版) 回應包含地點資料，包括位置資料和圖像、地理位置，以及重要搜尋點。

Text Search (新版)、Nearby Search (新版) 和 Place Details (新版) 的回應也可能包含 Google 地圖的連結。使用者可以瀏覽這些 Google 地圖連結，查看回覆中地點的額外資訊。

舉例來說，你搜尋加州舊金山的機場。然後，回應會在地點清單中加入舊金山國際機場 (SFO)。回應中 SFO 的 Place 物件會新增 googleMapsUri 欄位，其中包含 Google 地圖連結，可開啟 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 欄位。

舉例來說，下列「文字搜尋 (新版)」會在回應中加入所有 Google 地圖連結：

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 (New)，在 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

這個版本會在回應中，將 googleMapsUri 欄位新增至 Reviews 和 Photos 物件。瀏覽這些連結時，Google 地圖會開啟評論或相片。

舉例來說，下列 Text Search (新版) 回應包含每個地點的評論和相片：

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. 選取「執行」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。

  5. 在 API Explorer 面板中，選取

    全螢幕：展開 API Explorer 視窗。