Places API obsługuje istniejące interfejsy API autouzupełniania i autouzupełniania. Jeśli znasz te interfejsy API, funkcja autouzupełniania (nowość) wprowadzi te zmiany:
- Autouzupełnianie (nowość) korzysta z żądań POST HTTP. Przekazuj parametry w treści żądania lub w nagłówkach w ramach żądania POST HTTP. W przypadku istniejących interfejsów API parametry adresów URL przekazujesz natomiast za pomocą żądania HTTP GET.
- Autouzupełnianie (nowość) obsługuje jako mechanizm uwierzytelniania zarówno klucze interfejsu API, jak i tokeny OAuth.
- Autouzupełnianie obsługuje tylko format JSON (nowy).
W tabeli poniżej znajdziesz parametry istniejących interfejsów API autouzupełniania i autouzupełniania, których nazwy zostały zmienione lub zmodyfikowane pod kątem autouzupełniania (nowe), a także parametry, które nie są już obsługiwane.
| Bieżący parametr | Nowy parametr | Notatki |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Jeśli pominiesz zarówno locationBias, jak i locationRestriction, interfejs API domyślnie użyje promowania adresów IP. |
|
offset |
inputOffset |
|
radius |
locationBias lub locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Przykładowe żądanie
Poniższe przykładowe żądanie GET korzysta z istniejącej funkcji autouzupełniania miejsca. W tym przykładzie żądasz odpowiedzi JSON z informacjami o miejscach o nazwie „Amoeba”, które są 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'
Autouzupełnianie polega na wysłaniu żądania POST i przekazywaniu wszystkich parametrów w treści żądania JSON lub w nagłówkach w ramach żądania POST. W tym przykładzie zastosowano też maskę pola, dzięki czemu odpowiedź zawiera tylko wyświetlaną nazwę i sformatowany adres miejsca:
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" \
https://places.googleapis.com/v1/places:autocomplete