Wprowadzenie
Interfejs Places API obsługuje interfejsy Place Autocomplete (starszy) i Query Autocomplete (starszy). Jeśli znasz te interfejsy API, Autocomplete (New) wprowadza te zmiany:
- Autouzupełnianie (nowe) korzysta z żądania HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach w ramach żądania HTTP POST. W przeciwieństwie do starszych interfejsów API parametry URL przekazujesz za pomocą żądania HTTP GET.
- Autouzupełnianie (nowe) obsługuje zarówno klucze interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
- W przypadku funkcji Autocomplete (New) jako formatu odpowiedzi obsługiwany jest tylko JSON.
W tabeli poniżej znajdziesz parametry w usługach Autouzupełnianie miejsca (starsza wersja) i Autouzupełnianie zapytania (starsza wersja), które zostały zmienione lub zmodyfikowane w usłudze Autouzupełnianie (nowa wersja), a także parametry, które nie są już obsługiwane.
Bieżący parametr | Nowy parametr | Uwagi |
---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Jeśli pominiesz zarówno parametr locationBias , jak i locationRestriction , interfejs API domyślnie będzie używać kierowania na podstawie adresu IP. |
|
offset |
inputOffset |
|
radius |
locationBias lub locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Przykładowe żądanie
Ten przykładowy kod wysyła żądanie GET do interfejsu Autocomplete API miejsc (starsza wersja). W tym przykładzie wysyłasz żądanie odpowiedzi w formacie 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 Autocomplete (New) wysyłasz żądanie POST i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach w ramach żądania POST.
Maski pól nie są wymagane w przypadku żądań autouzupełniania (nowego), ale można ich używać do filtrowania konkretnych wyników w odpowiedzi. Na przykład poniższe żądanie używa maski pola, dzięki czemu odpowiedź zawiera tylko suggestions.placePrediction.text
sugestii:
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 (nowe).