Interfejs Places API umożliwia wyszukiwanie i pobieranie informacji o różnych typach miejsc za pomocą ciągu tekstowego lub na podstawie bliskości. Places API to starsza wersja Places API (nowość).
W tabeli poniżej znajdziesz odpowiednie wersje obu interfejsów API. Zapoznaj się z tym przewodnikiem, aby poznać główne różnice między tymi interfejsami API i przeprowadzić migrację do interfejsu 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 (nowość) | 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:
- Migracja na wyszukiwanie w pobliżu (nowa wersja)
- Migracja do wyszukiwania tekstowego (nowa wersja)
- Migracja do Szczegółów miejsca (nowa)
- Migracja na zdjęcie lokalizacji (nowa)
- Migracja na autouzupełnianie (nowa wersja)
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. Taki 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, które mają być zwracane w odpowiedzi. Następnie naliczymy opłatę tylko za żądane dane. Używanie maskowania pól to dobra praktyka projektowania, która pozwala uniknąć przesyłania niepotrzebnych danych, co z kolei pozwala uniknąć niepotrzebnego czasu przetwarzania i opłat.
spójne dane odpowiedzi dotyczące miejsca;
W przypadku dotychczasowych interfejsów API interfejsy API Szczegóły miejsca, Wyszukaj w pobliżu i Wyszukaj tekst 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 wyszukiwania oraz dotychczasowych typów w wyszukiwaniu z lokalizacją (nowy) i wyszukiwaniu tekstowym (nowy). Wszystkie nowe typy znajdują się w tabeli A.
Dynamiczne dane o miejscach
Places API (Nowy) obsługuje dane odpowiedzi dynamicznej, 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.