Przegląd

Wybierz platformę: Android iOS JavaScript Usługa internetowa
Interfejs Places API to usługa, która akceptuje żądania HTTP dotyczące danych lokalizacji za pomocą różnych metod. Zwraca sformatowane dane o lokalizacji oraz obrazy obiektów, miejsc geograficznych lub ważnych punktów zainteresowania.

Dlaczego warto korzystać z Places API

Utwórz funkcje uwzględniające lokalizację, aby udostępnić 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świetlać oferty 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 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 i niejednoznaczne lub kategoryczne zapytania.
  • Włącz funkcje autouzupełniania dla różnych typów wyszukiwania, np. konkretnych zapytań tekstowych lub zapytań sklasyfikowanych.
  • 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.

Jak działa interfejs 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. 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 Szczegóły miejsca (Nowe), aby zwrócić elementy adresu dla identyfikatora miejsca za pomocą klucza interfejsu API:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

Jak korzystać z interfejsu Places API

Poniżej znajdziesz czynności, które należy wykonać, aby skorzystać z 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 (nowy) i Zdjęcie miejsca (nowy).
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.
2 Wypróbuj podstawowe wyszukiwanie tekstu Wykonaj wyszukiwanie tekstowe za pomocą opcji Wyszukiwanie tekstowe (nowa).
3 Użycie identyfikatora miejsca w celu uzyskania dodatkowych informacji Wiele interfejsów API Google Maps Platform zwraca identyfikator miejsca jako część odpowiedzi. Użyj identyfikatorów miejsc, aby uzyskać szczegóły miejsca (nowa).
4 Zrób zdjęcie miejsca Usługa Zdjęcie miejsca (nowa) zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsca. Aby uzyskać dostęp do zdjęć danego miejsca, użyj opcji Zdjęcie miejsca (nowa).