Dlaczego warto korzystać z Places API
Twórz funkcje uwzględniające lokalizację, aby udostępniać użytkownikom szczegółowe dane o lokalizacji. Dane dostępne za pomocą interfejsu Places API są tworzone na podstawie jednego z najbardziej dokładnych, aktualnych i wszechstronnych modeli miejsc w rzeczywistym świecie. Oto przykładowe zastosowania aplikacji:
- Wyświetlanie ofert wynajmu apartamentów w większych aglomeracjach z wynikami kierowanymi do konkretnych miast.
- Dodaj szczegóły miejsca w aktualizacji stanu odbioru lub dostawy.
- Wyświetlanie listy parków w danym obszarze wraz ze zdjęciami i opiniami przesłanymi przez użytkowników.
- Udostępnianie osobom planującym podróże informacji kontaktowych, opinii i poziomów cen obiektów na trasie.
Co można robić za pomocą interfejsu Places API
Za pomocą interfejsu Places API możesz dodać do swoich aplikacji te funkcje:
- Wyświetlaj wyniki wyszukiwania miejsc na podstawie różnych typów zapytań użytkowników, takich jak tekst, pobliskie lokalizacje oraz niejednoznaczne lub kategoryczne zapytania.
- Włącz funkcje autouzupełniania w przypadku różnych typów wyszukiwania, np. konkretnych zapytań tekstowych lub zapytań dotyczących kategorii.
- Określ typ zwracanych informacji o miejscu, np. godziny otwarcia, podsumowanie, opinie użytkowników i zdjęcie.
- Dodaj zdjęcia wysokiej jakości do lokalizacji obsługiwanych przez aplikację.
Wiele interfejsów API Google Maps Platform obsługuje identyfikatory miejsc, które jednoznacznie wskazują 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, ale też interfejsów Geocoding API, Routes API i Address Validation API.
Gdy masz już identyfikator miejsca, możesz użyć interfejsu Places API, aby uzyskać więcej informacji o konkretnym obiekcie lub punkcie orientacyjnym, 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 interfejsu API: Places API to istniejące interfejsy API, a Places API (nowość) to nowa generacja interfejsów API.
Po wydaniu interfejsu Places API (New) pierwszym zadaniem jest wybranie zestawu interfejsów API, których chcesz używać. Dotyczy to nowych i obecnych klientów, którzy korzystają z interfejsów API. Z tego przewodnika dowiesz się, jakie są główne różnice między tymi 2 interfejsami API.
Jak działa interfejs Places API
Places API (nowość)
Interfejs Places API (nowy) przyjmuje żądania jako standardowy adres URL z określonym punktem końcowym usługi, takim jak /places lub places:searchText, i zwraca odpowiedź w formacie JSON. Interfejs Places API (nowy) obsługuje autoryzację za pomocą klucza API i tokena OAuth.
W tym przykładzie wysyłamy żądanie dotyczące szczegółów miejsca, aby zwrócić elementy adresu dla identyfikatora miejsca za pomocą klucza API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Interfejs Places API przyjmuje żądania w postaci standardowego adresu URL z określonym punktem końcowym usługi, takim jak /place lub /photo. Punkty końcowe akceptują również typ formatu określony w żądaniu, czyli JSON lub XML. Żądanie usługi używa parametrów odpowiednich dla tego konkretnego punktu końcowego, aby zawęzić zwracane dane.
W tym przykładzie wysyłamy żądanie dotyczące szczegółów miejsca, aby zwrócić elementy adresu dla 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 tym przypadku usługa używa podanego identyfikatora miejsca, aby znaleźć żądane miejsce i zwrócić komponenty adresu w formacie JSON.
Zasoby
Tabela poniżej zawiera podsumowanie zasobów dostępnych w interfejsie Places API.
| Places API | Places API (nowość) | Uwaga |
|---|---|---|
| Znajdź miejsce | Wyszukiwanie tekstu (nowa funkcja) | Nie ma nowej wersji Find Place. Został on zastąpiony przez wyszukiwanie tekstu (nowa wersja). |
| 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ć interfejsu Text Search (New) (Wyszukiwanie w pobliżu (nowy)), ponieważ interfejs Nearby Search (New) (Wyszukiwanie w pobliżu (nowy)) nie obsługuje wprowadzania tekstu. |
| Wyszukiwanie tekstu | Wyszukiwanie tekstu (nowa funkcja) | |
| Szczegóły miejsca | Szczegóły miejsca (nowa) | |
| Umieszczanie zdjęcia | Place Photo (Nowy) | |
| Autouzupełnianie miejsc | Autouzupełnianie (nowa wersja) | |
| Autouzupełnianie zapytań | Autouzupełnianie (nowa wersja) | Dodaliśmy funkcje do autouzupełniania (nowe) |
Jak korzystać z interfejsu Places API
Poniżej znajdziesz instrukcje dotyczące typowego przypadku użycia usługi Places API. Podczas tworzenia rozwiązania możesz używać dodatkowych punktów końcowych, takich jak wyszukiwanie w pobliżu i Zdjęcia miejsc.| 1 | Konfiguracja | Zacznij od konfiguracji projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji, a następnie dowiedz się, jak używać klucza API. W przypadku interfejsu Places API (Nowy) możesz też używać tokenów OAuth. |
| 2 | Wypróbuj podstawowe wyszukiwanie tekstu | Wykonaj wyszukiwanie tekstowe, korzystając z opcji Wyszukiwanie tekstowe (nowa) lub Wyszukiwanie tekstowe. |
| 3 | Użycie identyfikatora miejsca w celu uzyskania dodatkowych informacji | Wiele interfejsów API Google Maps Platform zwraca identyfikator miejsca w ramach odpowiedzi. Użyj identyfikatora miejsca, aby uzyskać szczegółowe informacje o danym miejscu. Zobacz artykuły Szczegóły miejsca (nowa wersja) i Szczegóły miejsca. |
| 4 | Zrób zdjęcie miejsca | Usługa Zdjęcia miejsca zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsca. Aby uzyskać dostęp do zdjęć danego miejsca, użyj Zdjęcia miejsca (nowa wersja) lub Szczegółów miejsca. |