Interfejs Places API obsługuje interfejsy Place Autocomplete (Legacy) i Query Autocomplete (Legacy). Jeśli znasz te interfejsy API, Autocomplete (Nowy) wprowadza następujące zmiany:
- Autouzupełnianie (nowa wersja) korzysta z żądań HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach jako część żądania HTTP POST. W przypadku starszych interfejsów API parametry adresu URL przekazujesz za pomocą żądania HTTP GET.
- Autouzupełnianie (nowa wersja) obsługuje jako mechanizm uwierzytelniania zarówno klucze API, jak i OAuth.
- W przypadku funkcji Autocomplete (Nowa) obsługiwany jest tylko format odpowiedzi JSON.
W tabeli poniżej znajdziesz parametry w sekcji Autouzupełnianie miejsc (starsza wersja) i Autouzupełnianie zapytań (starsza wersja), które zostały zmienione lub zmodyfikowane w sekcji Autouzupełnianie (nowa wersja), oraz parametry, które nie są już obsługiwane.
| Parametr prądu | Nowy parametr | Uwagi |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Jeśli pominiesz zarówno parametr locationBias, jak i locationRestriction, interfejs API będzie domyślnie używać ukierunkowania na adres IP. |
|
offset |
inputOffset |
|
radius |
locationBias lub locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Przykładowe żądanie
Ten przykładowy kod żądania GET używa autouzupełniania miejsc (starsza wersja). W tym przykładzie żądasz odpowiedzi JSON zawierającej informacje o miejscach o nazwie „Amoeba” typu establishment i przekazujesz wszystkie parametry jako parametry adresu URL:
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'
W przypadku funkcji Autocomplete (Nowa) wysyłasz żądanie POST, przekazując wszystkie parametry w treści żądania JSON lub w nagłówkach jako część żądania POST.
Maski pól nie są wymagane w przypadku żądań autouzupełniania (nowej wersji), ale można ich użyć do filtrowania określonych wyników w odpowiedzi. Na przykład żądanie poniżej używa maski pola, więc odpowiedź zawiera tylko pole suggestions.placePrediction.text z sugestycją:
curl -X POST -d '{
"input": "Amoeba",
"locationBias": {
"circle": {
"center": {
"latitude": 37.76999,
"longitude": -122.44696
},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete
Więcej informacji o używaniu masek pól znajdziesz w artykule Szczegóły miejsca (nowa wersja).