Metoda SearchDestinations
interfejsu Geocoding API zawiera teraz szczegółowe informacje o parkowaniu w miejscach docelowych. Te dane mogą pomóc użytkownikom w planowaniu podróży, ponieważ:
- informują o tym, jakie obiekty parkingowe są dostępne po przyjeździe;
- pomagają oszacować, ile czasu należy przeznaczyć na znalezienie miejsca parkingowego.
Żądanie informacji o parkowaniu
Aby otrzymywać informacje o parkowaniu, musisz uwzględnić
destinations.parkingOptions
w masce pola żądania. Użyj nagłówka X-Goog-FieldMask, aby określić pola, które mają się znaleźć w odpowiedzi.
Przykładowe żądanie 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
Interpretowanie odpowiedzi
Jeśli zażądasz, obiekt Destination w odpowiedzi będzie zawierał pole parkingOptions.
parkingOptions
Ten obiekt zawiera szczegółowe informacje o parkowaniu w miejscu docelowym.
Typy parkowania: flagi logiczne wskazują dostępność określonych typów parkowania:
freeParkingLot: wartość true, jeśli dostępne jest bezpłatne parkowanie na parkingu.paidParkingLot: wartość true, jeśli dostępne jest płatne parkowanie na parkingu.freeStreetParking: wartość true, jeśli dostępne jest bezpłatne parkowanie przy ulicy.paidStreetParking: wartość true, jeśli dostępne jest płatne parking przy ulicy.valetParking: wartość true, jeśli dostępne jest parkowanie z obsługą.freeGarageParking: wartość true, jeśli dostępne jest bezpłatne parkowanie w garażu.paidGarageParking: wartość true, jeśli dostępne jest płatne parkowanie w garażu.
Dostępność: wyliczenie wskazujące ogólny stopień trudności w znalezieniu miejsca parkingowego:
AVAILABILITY_UNSPECIFIED: informacje o dostępności miejsc parkingowych są niedostępne.PLENTY: zwykle łatwo znaleźć miejsce parkingowe.SOMEWHAT_DIFFICULT: znalezienie miejsca parkingowego może być trudne.DIFFICULT: znalezienie miejsca parkingowego jest często bardzo trudne.
Przykładowy fragment odpowiedzi
{
"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
}
]
}
Prześlij opinię
To jest eksperymentalna funkcja interfejsu Geocoding API. Będziemy wdzięczni za opinie przesyłane na geocoding-feedback-channel@google.com.