Omówienie interfejsu Places API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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

W tabeli poniżej znajdziesz odpowiednie wersje obu interfejsów API. Z tego przewodnika dowiesz się, jakie są najważniejsze 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 tekstowe (nowość) Nie ma nowej wersji usługi Znajdź miejsce (starsza wersja). Zastąpiła ją usługa Text Search (New).
Wyszukiwanie w pobliżu (starsza wersja) Wyszukiwanie w pobliżu (nowość) Wszystkie żądania korzystające ze starszej wersji interfejsu API, które zawierają zapytanie tekstowe, powinny używać interfejsu Text Search (New), ponieważ Nearby Search (New) nie obsługuje wprowadzania tekstu.
Wyszukiwanie tekstu (starsza wersja) Wyszukiwanie tekstowe (nowość)
Szczegóły miejsca (starsza wersja) Szczegóły miejsca (nowe)
Zdjęcia miejsc (starsza wersja) Zdjęcia miejsc (nowość)
Autouzupełnianie miejsc (starsza wersja) Autouzupełnianie (nowość)
Autouzupełnianie zapytań (starsza wersja) Autouzupełnianie (nowość) Funkcje dodane do autouzupełniania (nowego).

Przejście na nowe interfejsy API

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

Kluczowe funkcje dodane do Places API (nowość)

W tej sekcji opisujemy najważniejsze funkcje dodane do interfejsu Places API (nowego).

Wdrożone na standardowej platformie Google Cloud

Interfejs Places API (nowy) jest zaimplementowany w infrastrukturze usług w Google Cloud. Ta implementacja zapewnia bezpieczniejszą i bardziej zaufaną platformę z ulepszonymi opcjami zabezpieczeń, takimi jak OAuth. Ten standardowy projekt interfejsu API zapewnia spójność interfejsów API, co zwiększa wydajność programowania z użyciem interfejsu Places API (nowego).

Poprawiona wydajność

Nowy interfejs Places API zapewnia większą wydajność, dzięki czemu warto zastąpić nim aplikacje korzystające z dotychczasowego interfejsu Places API.

Uproszczone ceny

Ceny są uproszczone w przypadku interfejsu Places API (nowego), dzięki czemu płacisz tylko za wykorzystane dane. Uproszczone ustalanie cen jest wdrażane za pomocą maski pola.

W przypadku szczegółów miejsca (nowych), wyszukiwania w pobliżu (nowego) i wyszukiwania tekstowego (nowego) możesz użyć maski pola, aby określić listę pól, które mają zostać zwrócone w odpowiedzi. Wtedy opłata jest naliczana tylko za żądane dane. Używanie maskowania pól to dobra praktyka projektowania, która pozwala uniknąć wysyłania żądań dotyczących niepotrzebnych danych. Dzięki temu można uniknąć niepotrzebnego czasu przetwarzania i opłat.

spójne dane odpowiedzi dotyczące miejsca;

W przypadku starszych interfejsów API interfejsy Place Details (Legacy), Nearby Search (Legacy) i Text Search (Legacy) zwracały różne dane odpowiedzi dotyczące miejsca. Interfejs Places API (nowy) ujednolica 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 typ podstawowy miejsca, zgodnie z tabelą A.

Nowy interfejs API zawiera też kilka nowych typów. Możesz używać tych nowych typów, a także dotychczasowych typów w wyszukiwaniu za pomocą interfejsów Nearby Search (New) i Text Search (New). Nowe typy są uwzględnione w tabeli A.

Dynamiczne dane o miejscu

Places API (New) obsługuje dynamiczne dane odpowiedzi, takie jak dostępność stacji ładowania EV czy najnowsze ceny paliw na stacji benzynowej. Użyj tych pól odpowiedzi, aby tworzyć dynamiczne środowiska użytkownika.