Przenieś do wyszukiwania w pobliżu (nowość)

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 includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
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