Omówienie interfejsu Places API (starsza wersja)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

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 nimi, i jak przejść na Places API (nowość).

Places API (starsza wersja) Places API (nowość) Uwagi
Find Place (starsza wersja) Wyszukaj tekst (nowość) Nie ma nowej wersji Find Place (starsza wersja). Zastąpił ją Wyszukaj tekst (nowość).
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 korzystać z Wyszukaj tekst (nowość) ponieważ Wyszukiwanie w pobliżu (nowość) nie obsługuje wprowadzania tekstu.
Wyszukaj tekst (starsza wersja) Wyszukaj tekst (nowość)
Informacje o miejscu (starsza wersja) Informacje o miejscu (nowość)
Place Photos (starsza wersja) Place Photos (nowość)
Autouzupełnianie miejsc (starsza wersja) Autocomplete (nowość)
Query Autocomplete (starsza wersja) Autocomplete (nowość) Funkcje dodane do Autocomplete (nowość).

Migracja do nowych interfejsów API

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

Najważniejsze funkcje dodane do Places API (nowość)

W tej sekcji opisujemy najważniejsze funkcje dodane do Places API (nowość).

Wdrożone na standardowej platformie Google Cloud

Places API (nowość) jest wdrożony w infrastrukturze usług w Google Cloud. Dzięki temu jest to bezpieczniejsza i bardziej zaufana platforma z ulepszonymi opcjami zabezpieczeń, takimi jak OAuth. Standardowa konstrukcja interfejsu API zapewnia spójność między interfejsami API, co zwiększa wydajność tworzenia aplikacji za pomocą Places API (nowość).

Poprawiona wydajność

Places API (nowość) zapewnia lepszą wydajność, dzięki czemu warto zastąpić aplikacje korzystające z dotychczasowego Places API.

Uproszczone ceny

Ceny są uproszczone dzięki Places API (nowość), dzięki czemu płacisz tylko za wykorzystane dane. Uproszczone ceny są wdrażane za pomocą maski pola.

W przypadku informacji o miejscu (nowość), Wyszukiwania w pobliżu (nowość) i Wyszukiwania tekstowego (nowość) używasz maski pola, aby kontrolować listę pól, które mają zostać zwrócone w odpowiedzi. Opłata jest naliczana 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 informacje o miejscu (starsza wersja), Wyszukiwanie w pobliżu (starsza wersja) i Wyszukaj tekst (starsza wersja) zwracały różne dane odpowiedzi dotyczące miejsca. Places API (nowość) standaryzuje odpowiedź, dzięki czemu te interfejsy API zwracają te same dane dotyczące miejsca.

Rozszerzone typy miejsc

Odpowiedź interfejsu API może teraz zawierać podstawowy typ miejsca. Każde miejsce może mieć jedną wartość typu, która jest określona jako podstawowy typ miejsca, jak pokazano w tabeli A.

Nowy interfejs API zawiera też kilka nowych typów. Możesz używać tych nowych typów i dotychczasowych typów w wyszukiwaniu za pomocą Wyszukiwania w pobliżu (nowość) i Wyszukaj tekst (nowość). Wszystkie nowe typy są uwzględnione w tabeli A.

Dynamiczne dane o miejscach

Places API (nowość) 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 interfejsy użytkownika.