Places API obsługuje wyszukiwanie w pobliżu (starsza wersja). Jeśli znasz wyszukiwanie w pobliżu (starsza wersja), w wyszukiwaniu w pobliżu (nowa wersja) wprowadzono te zmiany:
- Wyszukiwanie w pobliżu (nowa wersja) używa żądań HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach jako część żądania HTTP POST. W przypadku wyszukiwania w pobliżu (wersja starsza) 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.
- Wyszukiwanie w pobliżu (nowa wersja) obsługuje jako mechanizm uwierzytelniania zarówno klucze API, jak i tokeny OAuth.
- W przypadku wyszukiwania w pobliżu (nowa wersja) obsługiwany jest tylko format odpowiedzi 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 w przypadku wyszukiwania w pobliżu (nowy) został zmieniony w porównaniu do starszych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.
Tabela poniżej zawiera parametry w usługach wyszukiwania w pobliżu (starsza wersja), które zostały zmienione lub zmodyfikowane w usługach wyszukiwania w pobliżu (nowa wersja), 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. Starsze wersje interfejsu API obsługują tylko jedną wartość. |
Przykładowe żądanie
Ten przykładowy kod żądania GET używa wyszukiwania w pobliżu (wersja starsza). W tym przykładzie żądasz odpowiedzi 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, przekazując 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 wyświetlaną nazwę 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