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 API i Address 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). |