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 nimi, i jak przejść na Places API (nowość).
| Places API (starsza wersja) | Places API (nowość) | Uwagi |
|---|---|---|
| Find Place (starsza wersja) | Text Search (nowość) | Nie ma nowej wersji Find Place (starsza wersja). Zastąpił ją interfejs Text Search (nowość). |
| Nearby Search (starsza wersja) | Nearby Search (nowość) | Wszystkie żądania korzystające ze starszego interfejsu API, które zawierają zapytanie tekstowe, powinny korzystać z interfejsu Text Search (nowość) ponieważ Nearby Search (nowość) nie obsługuje wprowadzania tekstu. |
| Text Search (starsza wersja) | Text Search (nowość) | |
| Place Details (starsza wersja) | Place Details (nowość) | |
| Place Photos (starsza wersja) | Place Photos (nowość) | |
| Place Autocomplete (starsza wersja) | Autocomplete (nowość) | |
| Query Autocomplete (starsza wersja) | Autocomplete (nowość) | Funkcje dodane do interfejsu Autocomplete (nowość). |
Migracja do nowych interfejsów API
Aby przejść na nowe interfejsy API, zapoznaj się z tymi przewodnikami po migracji:
- Migracja do interfejsu Nearby Search (nowość)
- Migracja do interfejsu Text Search (nowość)
- Migracja do interfejsu Place Details (nowość)
- Migracja do interfejsu Place Photos (nowość)
- Migracja do interfejsu Autocomplete (nowość)
Najważniejsze funkcje dodane do Places API (nowość)
W tej sekcji opisujemy najważniejsze funkcje dodane do Places API (nowość).
Wdrożony 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ść, dlatego warto zastąpić nim aplikacje korzystające z dotychczasowego Places API.
Uproszczone ceny
Ceny są uproszczone dzięki Places API (nowość), więc płacisz tylko za wykorzystane dane. Uproszczone ceny są wdrażane za pomocą maski pola.
W przypadku interfejsów Place Details (nowość), Nearby Search (nowość) i Text Search (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 Place Details (starsza wersja), Nearby Search (starsza wersja) i Text Search (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ą interfejsów Nearby Search (nowość) i Text Search (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żywaj tych pól odpowiedzi, aby tworzyć dynamiczne interfejsy użytkownika.