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, i przejdziesz 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 Wyszukiwanie tekstu (nowa). |
| 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ć interfejsu Wyszukiwanie tekstowe (nowe), ponieważ Wyszukiwanie w pobliżu (nowe) nie obsługuje wprowadzania tekstu. |
| Wyszukiwanie tekstu (starsza wersja) | Wyszukiwanie tekstowe (nowość) | |
| Szczegóły miejsca (starsza wersja) | Szczegóły miejsca (nowość) | |
| 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 (nowa wersja). |
Przejście na nowe interfejsy API
Aby przejść na nowe interfejsy API, zapoznaj się z tymi przewodnikami po migracji:
- Migracja do wyszukiwania w pobliżu (nowość)
- Migracja do wyszukiwania tekstowego (nowość)
- Migracja do szczegółów miejsca (nowość)
- Migracja do usługi Zdjęcia miejsc (nowość)
- Migracja do autouzupełniania (nowość)
Kluczowe funkcje dodane do Places API (nowość)
W tej sekcji omówiono najważniejsze funkcje dodane do Places API (nowość).
Wdrożone na standardowej platformie Google Cloud
Interfejs Places API (nowy) jest zaimplementowany w infrastrukturze usługi w Google Cloud. Wdrożenie to zapewnia bezpieczniejszą i bardziej zaufaną platformę z zaawansowanymi opcjami zabezpieczeń, takimi jak OAuth. Standardowa konstrukcja interfejsu API zapewnia spójność interfejsów API, co zwiększa wydajność programowania z użyciem interfejsu Places API (nowego).
Poprawiona wydajność
Places API (nowość) zapewnia lepszą wydajność, dzięki czemu warto zastąpić aplikacje korzystające z istniejącego 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 interfejsów Place Details (New), Nearby Search (New) i Text Search (New) 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. Pomaga to skrócić czas przetwarzania i uniknąć niepotrzebnych 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 API Places (nowość) standaryzuje odpowiedź, dzięki czemu wszystkie interfejsy API zwracają te same dane dotyczące miejsca.
Rozszerzone typy miejsc
Odpowiedź API może teraz zawierać typ podstawowy miejsca. Każde miejsce może mieć pojedynczą wartość typu, która jest określona jako podstawowy typ miejsca, jak przedstawiono w Tabeli 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.