Places API obsługuje Wyszukiwanie w pobliżu. Jeśli znasz już funkcję Wyszukiwanie w pobliżu, nowa wersja Wyszukiwania w pobliżu wprowadza następujące zmiany:
- Nowe wyszukiwanie w pobliżu używa żądań HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach jako część żądania POST HTTP użytkownika. W przeciwieństwie do dotychczasowej funkcji Wyszukiwanie w pobliżu parametry adresu URL 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 zwróconych pól. Jeśli pominiesz ale metody zwrócą błąd. Więcej informacji: FieldMask,
- Nowa funkcja wyszukiwania w pobliżu obsługuje Klucze interfejsu API i OAuth tokeny uwierzytelniania.
- W nowym formacie odpowiedzi obsługiwany jest tylko format JSON Wyszukiwanie w pobliżu.
- Wszystkie żądania zawierające zapytanie tekstowe powinny teraz używać ciągu Wyszukiwanie tekstowe (nowość) ponieważ Wyszukiwanie w pobliżu (nowość) nie obsługuje wprowadzania tekstu.
- Format odpowiedzi JSON dla funkcji Wyszukiwanie w pobliżu (nowość) Interfejs API różni się od formatu istniejących interfejsów API. Więcej informacji: Przenieś odpowiedź interfejsu Places API.
Poniższa tabela zawiera parametry w obecnym Wyszukiwanie w pobliżu, które zostało zmienione lub zmodyfikowane w odniesieniu do nowe Wyszukiwanie w pobliżu lub parametry, które nie są już obsługiwane.
| Bieżący parametr | Nowy parametr | Uwagi |
|---|---|---|
keyword |
Nieobsługiwane. Używaj Wyszukiwanie tekstowe (nowość) . | |
language |
languageCode |
|
location |
locationRestriction |
Wymagane. |
maxprice/minprice |
|
Nieobsługiwane. |
maxResultCount |
Nowy parametr. | |
opennow |
|
Nieobsługiwane. |
pagetoken |
Nieobsługiwane. | |
radius |
|
Użyj konta locationRestriction już teraz. |
rankby |
rankPreference |
|
regionCode |
Nowy parametr. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Nowe parametry obsługują też różne wartości typów. Istniejący interfejs API akceptuje tylko jedną wartość. |
Przykładowe żądanie
W tym przykładowym żądaniu GET jest używane
Wyszukiwanie w pobliżu. W tym przykładzie żądasz pliku JSON
odpowiedź zawierająca informacje o miejscach typu restaurant i spełniająca wszystkie
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'
Przy użyciu funkcji Wyszukiwanie w pobliżu (nowość) wysyłasz żądanie POST, a następnie przekazują wszystkie parametry w treści żądania JSON lub w nagłówkach w ramach metody POST, użytkownika. W tym przykładzie zastosowano również maskę pola, dzięki czemu odpowiedź zawiera tylko wartości wyświetlana nazwa 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