Wprowadzenie
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 i obrazy dotyczące obiektów, lokalizacji geograficznych lub ważnych punktów orientacyjnych.Dlaczego warto korzystać z Places API (nowość)
Twórz funkcje oparte na lokalizacji, aby udostępniać użytkownikom szczegółowe dane o lokalizacji. Dane dostępne w interfejsie Places API (nowym) są oparte na jednym z najdokładniejszych, najbardziej aktualnych i najbardziej kompleksowych modeli miejsc w rzeczywistym świecie. Oto przykładowe przypadki użycia aplikacji:
- Wyświetlaj oferty wynajmu mieszkań w głównych obszarach metropolitalnych, a wyniki kieruj do konkretnych miast.
- Uwzględnij szczegóły miejsca w aktualizacji stanu odbioru lub dostawy.
- Wyświetl listę parków w danym obszarze wraz ze zdjęciami i opiniami przesłanymi przez użytkowników.
- Udostępniaj osobom planującym wyjazdy informacje kontaktowe, opinie i poziomy cen obiektów znajdujących się na trasie.
Co można robić za pomocą interfejsu Places API (nowego)
Za pomocą interfejsu Places API (nowego) możesz w swoich aplikacjach korzystać z tych funkcji:
- Wyświetlanie wyników wyszukiwania miejsc na podstawie różnych typów zapytań użytkowników, takich jak wpisywanie tekstu, wyszukiwanie miejsc w pobliżu oraz niejednoznaczne lub kategoryczne zapytania użytkowników.
- Włącz funkcje autouzupełniania dla różnych typów wyszukiwania, np. konkretnych zapytań tekstowych lub zapytań kategorycznych.
- określać 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 Twoją aplikację.
Wiele interfejsów Google Maps Platform API 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 (nowego), ale także Geocoding API, Routes API i Address Validation API.
Gdy uzyskasz identyfikator miejsca, możesz użyć interfejsu Places API (nowego), aby poprosić o 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 Places API (nowość)
Interfejs Places API (nowy) przyjmuje żądania w postaci standardowego adresu URL z określonym punktem końcowym usługi, np. /places lub places:searchText, i zwraca odpowiedź JSON.
Interfejs Places API (nowy) obsługuje autoryzację za pomocą klucza interfejsu API i tokena OAuth.
W tym przykładzie wysyłamy żądanie informacji o miejscu (nowe), aby zwrócić komponenty adresu dla identyfikatora miejsca przy użyciu klucza interfejsu API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Jak korzystać z Places API (nowość)
Poniższe czynności opisują typowy scenariusz korzystania z usługi Places API. Podczas tworzenia rozwiązania możesz używać dodatkowych punktów końcowych, takich jak Wyszukiwanie w pobliżu (New) i Place Photos (New).| 1 | Konfiguracja | Skonfiguruj płatności, włącz interfejs Places API (nowy) i wyślij pierwsze żądanie. |
| 2 | Wypróbuj podstawowe wyszukiwanie tekstowe | Wydaj polecenie wyszukiwania tekstowego za pomocą funkcji Wyszukiwanie tekstowe (nowe). |
| 3 | Użyj identyfikatora miejsca, aby uzyskać więcej informacji | Wiele interfejsów API Google Maps Platform zwraca w odpowiedzi identyfikator miejsca. Używaj identyfikatorów miejsc, aby pobierać informacje o miejscu (nowe). |
| 4 | Pobieranie zdjęcia miejsca | Usługa Place Photos (Nowa) zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Użyj Place Photos (New), aby uzyskać dostęp do zdjęć miejsca. |