Wprowadzenie
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 (starsza wersja) to starsza wersja interfejsu Places API (nowość).
W tabeli poniżej znajdziesz odpowiadające sobie wersje obu interfejsów API. Z tego przewodnika dowiesz się, jakie są najważniejsze różnice między tymi interfejsami API i jak przejść na Places API (New).
| Places API (starsza wersja) | Places API (nowość) | Uwagi |
|---|---|---|
| Find Place (starsza wersja) | Text Search (New) | Nie ma nowej wersji usługi Find Place (starszego typu). Zastąpiła ją usługa Wyszukaj tekst (New). |
| Wyszukiwanie w pobliżu (starsza wersja) | Nearby Search (New) | 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. |
| Wyszukaj tekst (starsza wersja) | Text Search (New) | |
| Informacje o miejscu (starsza wersja) | Informacje o miejscu (nowa wersja) | |
| Place Photos (starsza wersja) | Place Photos (New) | |
| Autouzupełnianie miejsc (starsza wersja) | Autocomplete (New) | |
| Autouzupełnianie zapytania (starsza wersja) | Autocomplete (New) | Dodano funkcje do autouzupełniania (nowa wersja). |
Przejście na nowe interfejsy API
Aby przejść na nowe interfejsy API, zapoznaj się z tymi przewodnikami po migracji:
- Przejście na wyszukiwanie w pobliżu (nowa wersja)
- Migracja do usługi Wyszukaj tekst (New)
- Migracja do usługi Informacje o miejscu (nowej)
- Migracja do usługi Place Photos (New)
- Migracja do autouzupełniania (nowość)
Najważniejsze funkcje dodane do Places API (nowość)
W tej sekcji opisano najważniejsze funkcje dodane do interfejsu Places API (nowego).
Wdrożone na standardowej platformie Google Cloud
Interfejs Places API (New) jest zaimplementowany w infrastrukturze usług w Google Cloud. Ta implementacja zapewnia bezpieczniejszą i bardziej zaufaną platformę z ulepszonymi opcjami bezpieczeństwa, takimi jak OAuth. Ten standardowy projekt interfejsu API zapewnia spójność między interfejsami API, co zwiększa efektywność programowania z użyciem Places API (nowego).
Poprawiona wydajność
Interfejs Places API (nowy) zapewnia lepszą wydajność, dlatego warto zastąpić nim aplikacje korzystające z dotychczasowego interfejsu Places API.
Uproszczone ceny
Cennik Places API (New) został uproszczony, dzięki czemu płacisz tylko za dane, których używasz. Uproszczone ustalanie cen jest wdrażane za pomocą maski pola.
W przypadku usług Informacje o miejscu (nowa wersja), Wyszukiwanie w pobliżu (nowa wersja) i Wyszukiwanie tekstowe (nowa wersja) możesz użyć maski pola, aby określić listę pól, które mają zostać zwrócone w odpowiedzi. Opłaty będą naliczane tylko za żądane dane. Używanie maskowania pól to dobra praktyka projektowa, 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 (Legacy), Wyszukiwanie w pobliżu (Legacy) i Wyszukaj tekst (Legacy) 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 dotyczące miejsca.
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ślona jako główny 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 istniejących typów w wyszukiwaniu za pomocą funkcji Wyszukiwanie w pobliżu (nowe) i Wyszukiwanie tekstowe (nowe). Nowe typy są uwzględnione w tabeli A.
Dynamiczne dane miejsca
Places API (New) obsługuje dynamiczne dane odpowiedzi, takie jak dostępność stacji ładowania EV czy najnowsze ceny paliwa na stacji benzynowej. Użyj tych pól odpowiedzi, aby tworzyć dynamiczne środowiska użytkownika.