Omówienie interfejsu Places API (starsza wersja)

Interfejs Places API umożliwia wyszukiwanie i pobieranie informacji o różnych typach miejsc za pomocą ciągu tekstowego lub na podstawie bliskości. Interfejs Places API (starsza wersja) to starsza wersja interfejsu Places API (nowa wersja).

W tabeli poniżej znajdziesz odpowiednie wersje obu interfejsów API. Z tego przewodnika dowiesz się, na czym polegają główne różnice między tymi interfejsami API i jak przejść na interfejs Places API (nowy).

Places API (starsza wersja) Places API (nowość) Uwagi
Znajdź miejsce (starsza wersja) Wyszukiwanie tekstu (nowa funkcja) Nie ma nowej wersji Find Place. Został zastąpiony przez wyszukiwanie tekstu (nowa wersja).
Wyszukiwanie w pobliżu (starsza wersja) Wyszukiwanie w pobliżu (nowa funkcja) Wszystkie żądania korzystające ze starszego interfejsu API, które zawierają zapytanie tekstowe, powinny używać wyszukiwania tekstowego (nowego), ponieważ wyszukiwanie w pobliżu (nowe) nie obsługuje wprowadzania tekstu.
Wyszukiwanie tekstowe (starsza wersja) Wyszukiwanie tekstu (nowa funkcja)
Szczegóły miejsca (starsza wersja) Szczegóły miejsca (nowa)
Place Photo (starsza wersja) Place Photo (New)
Autouzupełnianie miejsc (starsza wersja) Autouzupełnianie (nowa wersja)
Autouzupełnianie zapytań (starsza wersja) Autouzupełnianie (nowa wersja) Dodaliśmy funkcje do Autouzupełniania (Nowe).

Migracja do nowych interfejsów API

Aby przejść na nowe interfejsy API, zapoznaj się z tymi przewodnikami po migracji:

Dodanie kluczowych funkcji do Places API (nowość)

Ta sekcja zawiera najważniejsze funkcje dodane do interfejsu Places API (New).

Wdrożone na platformie standardowej Google Cloud

Interfejs Places API (nowy) jest implementowany na infrastrukturze usługi w Google Cloud. Dzięki temu wdrożeniu użytkownicy będą mogli korzystać z bezpieczniejszej i bardziej zaufanej platformy z rozszerzonymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy projekt interfejsu API zapewnia spójność interfejsów API, co zwiększa wydajność programowania za pomocą interfejsu Places API (New).

Poprawiona wydajność

Interfejs Places API (nowość) zapewnia lepszą wydajność, dlatego warto zastąpić aplikacje korzystające z obecnego interfejsu Places API.

Uproszczone ustalanie cen

Interfejs Places API (nowy) upraszcza cennik, dzięki czemu płacisz tylko za dane, których używasz. Uproszczone ustalanie cen jest wdrażane za pomocą maski pola.

W przypadku zapytań Szczegóły miejsca (Nowość), Wyszukiwanie w pobliżu (Nowość) i Wyszukiwanie tekstowe (Nowość) możesz użyć maski pola, aby określić listę pól zwracanych w odpowiedzi. Będziesz wtedy płacić tylko za żądane dane. Używanie maskowania pól to dobra praktyka projektowania, która pozwala uniknąć żądania niepotrzebnych danych, co pomaga uniknąć niepotrzebnego czasu przetwarzania i opłat.

spójne dane odpowiedzi dotyczące miejsca;

W przypadku starszych interfejsów API interfejsy API Szczegóły miejsca (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja) i Wyszukiwanie tekstowe (starsza wersja) zwracały różne dane odpowiedzi dotyczące miejsca. Interfejs Places API (New) standaryzuje odpowiedź, dzięki czemu wszystkie te interfejsy API zwracają te same dane o miejscu.

Rozszerzone typy miejsc

Odpowiedź interfejsu API może teraz zawierać główny typ miejsca. Każde miejsce może mieć jedną wartość typu, która jest określana jako jego główny typ, jak podano w tabeli A.

Nowy interfejs API zawiera też kilka nowych typów. Możesz używać tych nowych typów oraz dotychczasowych typów w wyszukiwaniu z wyszukiwaniem w pobliżu (nowy) i wyszukiwaniem tekstowym (nowy). Wszystkie nowe typy znajdują się w tabeli A.

Dynamiczne dane o miejscach

Places API (Nowy) obsługuje dane dynamiczne, takie jak dostępność stacji ładowania EV czy najnowsze ceny paliwa na stacji benzynowej. Użyj tych pól odpowiedzi, aby tworzyć dynamiczne wrażenia użytkowników.