Places API obsługuje istniejące wyszukiwanie w pobliżu. Jeśli korzystasz już z wyszukiwania w pobliżu, nowa wersja tej funkcji wprowadza następujące zmiany:
- Nowe wyszukiwanie w pobliżu używa żądań POST HTTP. Przekazuj parametry w treści żądania lub w nagłówkach w ramach żądania POST HTTP. W przeciwieństwie do obecnej funkcji wyszukiwania w pobliżu przekazujesz parametry adresu URL za pomocą żądania HTTP GET.
- Maskowanie pól jest wymagane. Musisz określić pola, które chcesz zwrócić w odpowiedzi. Nie ma domyślnej listy zwróconych pól. Jeśli pominiesz tę listę, metody zwrócą błąd. Więcej informacji znajdziesz w sekcji FieldMask (Maska pola).
- Nowe wyszukiwanie w pobliżu obsługuje zarówno klucze interfejsu API, jak i tokeny OAuth.
- W nowym wyszukiwaniu w pobliżu obsługiwane są tylko pliki JSON jako format odpowiedzi.
- Wszystkie żądania zawierające zapytanie tekstowe powinny teraz korzystać z funkcji Wyszukiwanie tekstowe (nowe), ponieważ Wyszukiwanie w pobliżu (nowe) nie obsługuje wprowadzania tekstu.
- Format odpowiedzi JSON dla interfejsu w pobliżu (nowego) interfejsu API wyszukiwania został zmieniony i nie różni się od formatu dotychczasowych interfejsów API. Więcej informacji znajdziesz w artykule o migracji odpowiedzi interfejsu Places API.
W tabeli poniżej znajdziesz parametry istniejące w funkcji Wyszukiwanie w pobliżu, które zostały zmienione lub zmodyfikowane w związku z nowym wyszukiwaniem w pobliżu albo te, które nie są już obsługiwane.
Bieżący parametr | Nowy parametr | Uwagi |
---|---|---|
keyword |
Nieobsługiwane. Użyj funkcji Wyszukiwanie tekstowe (nowość). | |
language |
languageCode |
|
location |
locationRestriction |
To pole jest wymagane. |
maxprice/minprice |
|
Nieobsługiwane. |
maxResultCount |
Nowy parametr. | |
opennow |
|
Nieobsługiwane. |
pagetoken |
Nieobsługiwane. | |
radius |
|
Skorzystaj z usługi locationRestriction już teraz. |
rankby |
rankPreference |
|
regionCode |
Nowy parametr. | |
type |
includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes
|
Nowe parametry mogą też przyjmować wartości wielu typów. Istniejący interfejs API akceptuje tylko 1 wartość. |
Przykładowe żądanie
Podane niżej przykładowe żądanie GET wykorzystuje istniejące wyszukiwanie w pobliżu. W tym przykładzie wysyłasz żądanie 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'
Funkcja wyszukiwania w pobliżu (nowość) wysyła żądanie POST i przekazuje wszystkie parametry w treści żądania JSON lub w nagłówkach w ramach żą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