Places API obsługuje Wyszukiwanie tekstowe. Jeśli znacie Wyszukiwanie tekstowe, nowa wersja wyszukiwania tekstowego wprowadza następujące zmiany:
- Nowe wyszukiwanie tekstowe korzysta z żądań HTTP POST. Powodzenie w treści żądania lub w nagłówkach jako część żądania POST HTTP. W przeciwieństwie do dotychczasowej funkcji wyszukiwania tekstowego przekazuje się 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,
- Nowe wyszukiwanie tekstowe obsługuje oba klucze interfejsu API i tokeny OAuth jako mechanizmu uwierzytelniania.
- W nowym formacie odpowiedzi obsługiwany jest tylko format JSON Wyszukiwanie tekstowe.
Obecne wyszukiwanie tekstowe umożliwia określenie szerokości i długości geograficznej w ciągu zapytania. Na przykład:
query=37.4239,-122.0925. Ta opcja nie jest obsługiwana w nowym wyszukiwaniu tekstowym.Używaj Odwrotne geokodowanie aby wyszukać współrzędne i zwrócić adres, Wyszukiwanie w pobliżu (nowość) do znajdowania miejsc w pobliżu określonej lokalizacji.
- Format odpowiedzi JSON dla wyszukiwania tekstowego (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 tekstowe, które zostało zmienione lub zmodyfikowane w odniesieniu do nowego wyszukiwania tekstowego lub parametrów, które już nie są obsługiwane.
| Bieżący parametr | Nowy parametr | Uwagi |
|---|---|---|
evOptions |
Nowy parametr. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
Nieobsługiwane. | |
query |
textQuery |
Wymagane we wszystkich żądaniach. |
radius |
locationBias |
Podczas definiowania pola locationBias określ promień. |
region |
regionCode |
|
type |
includedType |
Przyjmuje tylko jedną wartość. |
strictTypeFiltering |
Nowy parametr. |
Przykładowe żądanie
W tym przykładowym żądaniu GET jest używane Wyszukiwanie tekstowe. W tym przykładzie żądasz pliku JSON odpowiedź zawierająca informacje „pikantne potrawy wegetariańskie w Sydney, Australia i przekazywać wszystkie parametry jako parametry adresu URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
W przypadku wyszukiwania tekstowego (nowego) 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 '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'