Interfejs Places API obsługuje dotychczasową funkcję wyszukiwania w pobliżu. Jeśli znasz dotychczasową wyszukiwarkę w pobliżu, nowa wersja wyszukiwarki w pobliżu wprowadza te zmiany:
- Nowa funkcja wyszukiwania w pobliżu korzysta z żądań HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach jako część żądania HTTP POST. W przypadku dotychczasowej funkcji wyszukiwania w pobliżu parametry adresu URL są przekazywane za pomocą żądania HTTP GET.
- Maskowanie pól jest wymagane. Musisz określić, które pola mają być zwracane w odpowiedzi. Nie ma domyślnej listy zwracanych pól. Jeśli pominiesz tę listę, metody zwrócą błąd. Więcej informacji znajdziesz w artykule FieldMask.
- Nowa funkcja wyszukiwania w pobliżu obsługuje jako mechanizm uwierzytelniania zarówno klucze API, jak i tokeny OAuth.
- W nowej usłudze wyszukiwania w pobliżu obsługiwany jest tylko format JSON.
- Wszystkie żądania, które zawierają zapytanie tekstowe, powinny teraz używać wyszukiwania tekstowego (nowego), ponieważ wyszukiwanie w pobliżu (nowe) nie obsługuje wprowadzania tekstu.
- Format odpowiedzi JSON interfejsu API wyszukiwania w pobliżu (nowy) różni się od formatu istniejących interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.
W tabeli poniżej znajdziesz parametry z dotychczasowej funkcji wyszukiwania w pobliżu, które zostały zmienione lub zmodyfikowane na potrzeby nowej funkcji wyszukiwania w pobliżu, oraz parametry, które nie są już obsługiwane.
| Parametr prądu | Nowy parametr | Uwagi |
|---|---|---|
keyword |
Nieobsługiwane. Zamiast tego użyj kolumny Wyszukiwanie tekstowe (nowa). | |
language |
languageCode |
|
location |
locationRestriction |
Wymagane. |
maxprice/minprice |
|
Nieobsługiwane. |
maxResultCount |
Nowy parametr. | |
opennow |
|
Nieobsługiwane. |
pagetoken |
Nieobsługiwane. | |
radius |
|
Skorzystaj z funkcji locationRestriction. |
rankby |
rankPreference |
|
regionCode |
Nowy parametr. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Nowe parametry mogą też przyjmować różne wartości typu. Obecna wersja interfejsu API przyjmuje tylko jedną wartość. |
Przykładowe żądanie
Ten przykładowy żądanie GET korzysta z dostępnej funkcji wyszukiwania w pobliżu. W tym przykładzie żądasz odpowiedzi w formacie JSON zawierającej informacje o miejscach typu restaurant i przekazujesz wszystkie parametry jako parametry adresu URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
W przypadku wyszukiwania w pobliżu (nowej wersji) wysyłasz żądanie POST i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach jako część żądania POST. W tym przykładzie użyto też maski pola, więc odpowiedź zawiera tylko nazwę wyświetlaną i sformatowany adres miejsca:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby