Wprowadzenie
Interfejs Places API to usługa, która przyjmuje żądania HTTP dotyczące danych o lokalizacji za pomocą różnych metod. Zwraca sformatowane dane o lokalizacji i obrazy dotyczące firm, lokalizacji geograficznych lub ważnych miejsc.Dlaczego warto korzystać z Places API (nowość)
Twórz funkcje uwzględniające lokalizację, aby udostępniać użytkownikom szczegółowe dane o lokalizacji. Dane dostępne w Places API (nowość) są oparte na jednym z najdokładniejszych, najbardziej aktualnych i kompleksowych modeli miejsc na świecie. Oto przykładowe przypadki użycia aplikacji:
- Wyświetlanie wynajmu mieszkań w dużych aglomeracjach miejskich z wynikami kierowanymi konkretnie na miasta.
- Dodawanie szczegółów miejsca do 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 w obiektach znajdujących się na trasie.
Co można zrobić za pomocą Places API (nowość)
Za pomocą Places API (nowość) możesz dodać do swoich aplikacji te funkcje:
- Wyświetlanie wyników wyszukiwania miejsc na podstawie różnych typów zapytań użytkowników, takich jak wprowadzanie tekstu, lokalizacje w pobliżu oraz niejednoznaczne lub kategoryczne zapytania użytkowników.
- Włączanie funkcji autouzupełniania dla różnych typów wyszukiwania, zarówno zapytań tekstowych, jak i kategorycznych.
- Doprecyzowanie typu zwracanych informacji o miejscu, takich jak godziny otwarcia, podsumowanie, opinie użytkowników i zdjęcie.
- Dodawanie zdjęć wysokiej jakości do lokalizacji obsługiwanych przez 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ą Places API (nowość), ale też za pomocą Geocoding API, Routes API i Address Validation API.
Gdy masz już identyfikator miejsca, możesz użyć Places API (nowość), aby poprosić o więcej informacji o konkretnym obiekcie lub miejscu, takich jak pełny adres, numer telefonu, ocena użytkowników i opinie.
Jak działa Places API (nowość)
Places API (nowość) przyjmuje żądania jako standardowy adres URL z określonym punktem końcowym usługi, np. /places lub places:searchText, i zwraca odpowiedź w formacie JSON.
Places API (nowość) obsługuje autoryzację za pomocą klucza API i tokena OAuth.
Ten przykład wysyła żądanie informacji o miejscu (nowość), aby zwrócić komponenty 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 Places API (nowość)
Poniższe czynności opisują typowy przypadek 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 (nowość) i Place Photos (nowość).| 1 | Konfiguracja | Skonfiguruj płatności, włącz Places API (nowość) i wyślij pierwsze żądanie. |
| 2 | Wypróbuj podstawowe wyszukiwanie tekstowe | Wyślij wyszukiwanie tekstowe za pomocą Text Search (nowość). |
| 3 | Użyj identyfikatora miejsca, aby uzyskać więcej informacji | Wiele interfejsów Google Maps Platform API zwraca identyfikator miejsca w ramach a odpowiedzi. Użyj identyfikatorów miejsc, aby uzyskać informacje o miejscu (nowość). |
| 4 | Pobierz zdjęcie miejsca | Place Photos (nowość) umożliwia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Użyj Place Photos (nowość), aby uzyskać dostęp do zdjęć miejsca. |