Dlaczego warto korzystać z interfejsu Places API
Twórz funkcje z uwzględnieniem lokalizacji, aby łatwo udostępniać użytkownikom szczegółowe dane o lokalizacji. Dane dostępne przez interfejs Places API są oparte na jednym z najbardziej dokładnych, aktualnych i kompleksowych modeli miejsc w świecie rzeczywistym. Oto przykładowe przypadki użycia aplikacji:
- Wyświetlaj mieszkania na wynajem w dużych obszarach miejskich z wynikami kierowanymi na miasta.
- Dodaj szczegóły miejsca w informacjach o stanie dostawy lub odbioru.
- wyświetlać listę parków na danym obszarze wraz ze zdjęciami i opiniami przesłanymi przez użytkowników;
- Przekaż osobom planującym wyjazdy informacje kontaktowe, opinie i poziomy cenowe w danym miejscu.
Do czego służy interfejs Places API
Za pomocą interfejsu Places API możesz uwzględnić w swoich aplikacjach te funkcje:
- Podaj wyniki wyszukiwania miejsc pochodzące z różnych typów zapytań użytkowników, np. zapytań tekstowych, lokalizacji w pobliżu oraz niejednoznacznych lub niejednoznacznych zapytań kategorialnych.
- Włącz funkcje autouzupełniania dla różnych typów wyszukiwania: konkretnych zapytań tekstowych lub zapytań kategorialnych.
- Doprecyzuj typ zwracanych informacji o miejscu, takich jak godziny otwarcia, podsumowanie, opinie użytkowników i zdjęcie.
- Dodawaj zdjęcia wysokiej jakości do lokalizacji obsługiwanych przez Twoją aplikację.
Wiele interfejsów API Google Maps Platform obsługuje identyfikatory miejsc, które jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google. Identyfikator miejsca można uzyskać na wiele sposobów, m.in. za pomocą interfejsu Places API, a także Geocoding API, Routes API i Address Billingation API.
Mając identyfikator miejsca, możesz użyć interfejsu Places API, aby poprosić o więcej szczegółowych informacji o konkretnej instytucji lub ciekawej lokalizacji, takich jak pełny adres, numer telefonu, ocena użytkowników i opinie.
Wybierz wersję interfejsu Places API
Interfejs Places API obsługuje 2 wersje API: Places API to dotychczasowe interfejsy API, a Places API (nowy) to nowe wersje interfejsów API.
Po wprowadzeniu nowego interfejsu Places API Twoim pierwszym zadaniem jest wybór zestawu interfejsów API, którego chcesz używać. Dotyczy to nowych lub obecnych klientów, którzy korzystają już z interfejsów API. Z tego przewodnika dowiesz się, jakie są główne różnice między tymi dwoma interfejsami API.
Jak działa interfejs Places API
Places API (nowość)
Places API (nowość) akceptuje żądania jako standardowy adres URL z określonym punktem końcowym usługi, takim jak /places lub places:searchText, i zwraca odpowiedź JSON. Places API (nowy) obsługuje autoryzację za pomocą klucza interfejsu API i tokena OAuth.
Ten przykład powoduje utworzenie żądania Szczegóły miejsca, które zwraca za pomocą klucza interfejsu API komponenty adresu dla identyfikatora miejsca:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Interfejs Places API przyjmuje żądania jako standardowy adres URL z określonym punktem końcowym usługi, np. /place lub /photo. Punkty końcowe akceptują też typ formatu podany w żądaniu (JSON lub XML). Żądanie usługi używa parametrów odpowiednich dla tego konkretnego punktu końcowego, aby doprecyzować zwracane dane.
Ten przykład powoduje utworzenie żądania Szczegóły miejsca, które zwraca komponenty adresu identyfikatora miejsca w formacie JSON:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
W tej instancji usługa używa podanego identyfikatora miejsca, aby znaleźć żądane miejsce i zwrócić komponenty adresu w formacie JSON.
Zasoby
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w interfejsie Places API.
| Places API | Places API (nowość) | Uwaga |
|---|---|---|
| Znajdź miejsce | Wyszukiwanie tekstowe (nowość) | Nie ma nowej wersji aplikacji Znajdź miejsce. Wyszukiwanie tekstowe (nowość) je zastąpiło. |
| Wyszukiwanie w pobliżu | Wyszukiwanie w pobliżu (nowość) | Wszystkie żądania korzystające z dotychczasowego interfejsu API, które zawierają zapytanie tekstowe, powinny używać wyszukiwania tekstowego (nowego), ponieważ funkcja Wyszukiwanie w pobliżu (nowa wersja) nie obsługuje wprowadzania tekstu. |
| Wyszukiwanie tekstowe | Wyszukiwanie tekstowe (nowość) | |
| Szczegóły miejsca | Szczegóły miejsca (nowość) | |
| Zdjęcie miejsca | Zdjęcie miejsca (nowość) | |
| Autouzupełnianie miejsc | Autouzupełnianie (nowość) | W trybie podglądu |
| Autouzupełnianie zapytań | Autouzupełnianie (nowość) | Funkcje dodane do wersji testowej autouzupełniania (nowość) |
Jak korzystać z interfejsu Places API
Poniżej opisaliśmy typowy scenariusz użycia usługi Places API. Podczas tworzenia rozwiązania możesz używać dodatkowych punktów końcowych, np. wyszukiwania w pobliżu i zdjęć miejsc.| 1 | Skonfiguruj | Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z podanymi poniżej instrukcjami, a potem dowiedz się, jak używać klucza interfejsu API. W nowym interfejsie Places API możesz też używać tokenów OAuth. |
| 2 | Podstawowe wyszukiwanie tekstowe | Proste wyszukiwanie tekstu możesz przeprowadzić przy użyciu wyszukiwania (nowego) lub tekstowego. |
| 3 | Aby uzyskać więcej informacji, użyj identyfikatora miejsca | Wiele interfejsów Google Maps Platform API zwraca w odpowiedzi identyfikator miejsca. Aby uzyskać informacje o danym miejscu, użyj identyfikatora miejsca. Patrz Szczegóły miejsca (nowość) i Szczegóły miejsca. |
| 4 | Zdjęcia miejsca | Usługa Zdjęcia miejsc zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Użyj zdjęcia miejsca (nowość) lub szczegółów miejsca, aby uzyskać dostęp do zdjęć miejsca. |