Przegląd

Interfejs Places API to usługa, która akceptuje żądania HTTP dotyczące danych o 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 (nowość)

Tworzenie funkcji wykorzystujących lokalizację, aby udostępniać użytkownikom szczegółowe dane o lokalizacji. Dane dostępne za pomocą interfejsu Places API (New) są oparte na jednym z najbardziej dokładnych, aktualnych i wszechstronnych modeli miejsc w rzeczywistym świecie. Oto przykładowe przypadki użycia aplikacji:

  • Wyświetlanie ofert wynajmu apartamentów w głównych obszarach metropolitalnych z wynikami ukierunkowanymi na konkretne miasta.
  • 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 (nowość)

Za pomocą interfejsu Places API (New) 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, lokalizacje w pobliżu oraz niejednoznaczne lub kategoryczne zapytania użytkowników.
  • Włącz funkcje autouzupełniania dla różnych typów wyszukiwania: określonych zapytań tekstowych lub zapytań wg 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 (New), ale też interfejsów Geocoding API, Routes APIAddress Validation API.

Gdy masz już identyfikator miejsca, możesz użyć interfejsu Places API (New), aby poprosić o dodatkowe informacje o konkretnym obiekcie lub punkcie zainteresowania, takie 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, 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 Szczegóły miejsca (Nowe), aby pobrać 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 (nowość)

Poniżej znajdziesz instrukcje dotyczące typowego przypadku użycia usługi Places API. Podczas tworzenia rozwiązania możesz korzystać z dodatkowych punktów końcowych, takich jak wyszukiwanie w pobliżu (nowy) i Zdjęcia miejsc (nowy).
1 Konfiguracja Zacznij od konfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji, a potem 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 miejsc (nowa wersja).
4 Zdobywanie zdjęcia miejsca Zdjęcia miejsca (nowa funkcja) zapewniają dostęp do milionów zdjęć przechowywanych w bazie danych Miejsca. Aby uzyskać dostęp do zdjęć danego miejsca, użyj sekcji Zdjęcia miejsc (nowa).