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 tekstu (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 tekstowe (starsza wersja) | Wyszukiwanie tekstu (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 interfejsu Place Details (nowość)
- Migracja do usługi Zdjęcia miejsc (nowość)
- Migracja do autouzupełniania (nowość)
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ługi w Google Cloud. Wdrożenie to zapewnia bezpieczniejszą i bardziej zaufaną platformę z zaawansowanymi 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ść
Interfejs Places API (nowy) zapewnia większą wydajność, dlatego 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 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 (starszy), Nearby Search (starszy) i Text Search (starszy) 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.