Places API (新版) 接受透過多種方法提出的地點資料要求。Places API (新版) 回應包含地點相關資料，包括位置資料和圖像、地理位置，以及重要搜尋點。
Text Search (新版)、Nearby Search (新版) 和 Place Details (新版) 的回應也可能包含 Google 地圖連結。使用者可以瀏覽這些 Google 地圖連結，查看回覆中地點的額外資訊。
舉例來說，假設你搜尋美國加州舊金山的機場，回應的地點清單中就會包含舊金山國際機場 (SFO)。回應中 SFO 的 Place 物件會新增 googleMapsUri 欄位，其中包含 Google 地圖連結，可開啟 Google 地圖前往該地點、取得前往該地點的路線、查看該地點的評論和相片。
除了新增至 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 回應中加入所有連結
地點回應中的連結包含在 googleMapsLinks 欄位中。如要在回應中顯示這些欄位，請務必在要求的欄位遮罩中加入 googleMapsLinks 欄位。
舉例來說，下列 Text Search (New) 會在回應中包含所有 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 (新版)，在回應的 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 地圖中開啟評論或相片。
舉例來說，下列 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 選項。
選取頁面右側的 API 圖示。
視需要展開「Show standard parameters」(顯示標準參數)，並將
fields參數設為欄位遮罩。視需要編輯「Request body」(要求主體)。
選取「Execute」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。
在 API Explorer 面板中，選取
全螢幕：展開 APIs Explorer 視窗。