Wprowadzenie
Starsza wersja interfejsu Places API obsługuje Wyszukiwanie tekstowe (starsza wersja). Jeśli znasz interfejs wyszukiwania tekstowego (starsza wersja), interfejs wyszukiwania tekstowego (nowa wersja) wprowadza te zmiany:
- Wyszukiwanie tekstowe (nowe) korzysta z żądań HTTP POST. Przekazywanie parametrów w treści żądania lub w nagłówkach w ramach żądania HTTP POST. W przypadku wyszukiwania tekstowego (starszego) parametry adresu URL przekazujesz za pomocą żądania HTTP GET.
- Maskowanie pola 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 sekcji FieldMask.
- Wyszukiwanie tekstowe (nowe) obsługuje zarówno klucze interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
- W przypadku wyszukiwania tekstowego (nowego) jako formatu odpowiedzi obsługiwany jest tylko JSON.
Wyszukiwanie tekstowe (starsza wersja) umożliwia określanie współrzędnych szerokości i długości geograficznej w ciągu zapytania. Przykład:
query=37.4239,-122.0925. Ta opcja nie jest obsługiwana w wyszukiwaniu tekstowym (nowym).Użyj odwrotnego geokodowania, aby wyszukiwać na podstawie współrzędnych i uzyskiwać adresy, lub wyszukiwania w pobliżu (nowego), aby znajdować miejsca w określonej lokalizacji.
- Format odpowiedzi JSON w przypadku wyszukiwania tekstowego (nowego) zmienił się w porównaniu z formatem starszych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.
W tabeli poniżej znajdziesz parametry w wyszukiwarce tekstowej (starszej wersji), które zostały zmienione lub zmodyfikowane w wyszukiwarce tekstowej (nowej wersji), oraz parametry, które nie są już obsługiwane.
| Bieżący parametr | Nowy parametr | Uwagi |
|---|---|---|
evOptions |
Nowy parametr. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
pageToken |
|
query |
textQuery |
Wymagany we wszystkich żądaniach. |
radius |
locationBias |
Podczas definiowania locationBias podaj promień. |
region |
regionCode |
|
type |
includedType |
Przyjmuje tylko jedną wartość. |
strictTypeFiltering |
Nowy parametr. |
Przykładowe żądanie
Ten przykładowy kod żądania GET korzysta z wyszukiwania tekstowego (starsza wersja). W tym przykładzie wysyłasz żądanie odpowiedzi w formacie JSON zawierającej informacje o „pikantnych daniach wegetariańskich w Sydney w Australii” i przekazujesz 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 i przekazujesz wszystkie parametry w treści żądania JSON lub w nagłówkach w ramach żądania POST. W tym przykładzie użyto też maski pola, dzięki czemu odpowiedź zawiera tylko wyświetlaną nazwę 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'