Geocoding API 的 SearchDestinations 方法現在包含目的地的詳細停車資訊。這項資料可協助使用者規劃行程,方法如下:
- 瞭解抵達時的停車設施。
- 評估尋找停車位所需的時間。
要求停車資訊
如要接收停車資訊,請務必在要求欄位遮罩中加入
destinations.parkingOptions
。使用 X-Goog-FieldMask 標頭指定要在回應中傳回的欄位。
cURL 要求範例
curl -X POST -d '{
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: destinations.primary.place,destinations.parkingOptions" \
https://geocode.googleapis.com/v4alpha/geocode/destinations
瞭解回覆內容
如果要求,回應中的 Destination 物件會包含 parkingOptions 欄位。
parkingOptions
這個物件包含目的地停車狀況的詳細資料。
停車位類型:布林值標記會指出特定停車位類型是否可用:
freeParkingLot:如果提供免費停車位,則為 True。paidParkingLot:如果提供付費停車位,則為 True。freeStreetParking:如果提供免費路邊停車位,則為 True。paidStreetParking:如果提供付費路邊停車位,則為 True。valetParking:如果提供代客停車服務,則為 True。freeGarageParking:如果提供免費車庫停車位,則為 True。paidGarageParking:如果提供付費室內停車場,則為 True。
Availability:列舉,指出停車位的一般難易度:
AVAILABILITY_UNSPECIFIED:無法提供停車資訊。PLENTY:通常很容易找到停車位。SOMEWHAT_DIFFICULT:停車位可能不好找。DIFFICULT:停車位通常很難找。
回覆程式碼片段範例
{
"destinations": [
{
"primary": {
"place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
// ... other primary place fields
},
"parkingOptions": {
"freeParkingLot": true,
"paidParkingLot": false,
"freeStreetParking": true,
"paidStreetParking": true,
"valetParking": false,
"freeGarageParking": false,
"paidGarageParking": true,
"availability": "SOMEWHAT_DIFFICULT"
}
// ... other destination fields
}
]
}
意見回饋
這是 Geocoding API 的實驗功能。歡迎傳送電子郵件至 geocoding-feedback-channel@google.com 提供意見。