Dlaczego warto korzystać z interfejsu Places API
Twórz funkcje dostępu do lokalizacji, aby ułatwić użytkownikom udostępnianie szczegółowych danych o lokalizacji. Dane dostępne za pomocą interfejsu Places API są oparte na jednym z najdokładniejszych, aktualnych i kompleksowych modeli miejsc w świecie rzeczywistym. Oto przykładowe przypadki użycia aplikacji:
- Wyświetlaj mieszkania w dużych aglomeracjach, podając wyniki dotyczące konkretnych miast.
- Podaj szczegółowe informacje o miejscu w aktualizacji stanu odbioru lub dostawy.
- Wyświetlaj listę parków w okolicy, wraz ze zdjęciami i opiniami użytkowników.
- Osoby planujące podróż mogą podać dane kontaktowe, opinie i poziomy cen obowiązujące w hotelach.
Co można zrobić za pomocą interfejsu Places API
Za pomocą interfejsu Places API możesz dodawać do aplikacji te funkcje:
- Wyniki wyszukiwania miejsc udostępniane na podstawie różnych typów zapytań użytkowników, takich jak wpisy tekstowe, lokalizacje w pobliżu oraz niejednoznaczne lub kategorialne zapytania użytkowników.
- Włącz funkcje autouzupełniania dla różnych typów wyszukiwania – konkretnych zapytań tekstowych lub kategorii.
- Doprecyzuj typ zwracanych informacji o miejscu, np. godziny otwarcia, podsumowanie, opinie użytkowników i zdjęcie.
- Dodawaj zdjęcia w wysokiej jakości do lokalizacji obsługiwanych przez aplikację.
Jak działa interfejs Places API
Interfejs Places API akceptuje żądania jako standardowy adres URL z określonym punktem końcowym usługi, takim jak /place
lub /photo
. Punkty końcowe mogą też obsługiwać pliki w formacie JSON lub XML określonym w żądaniu. Na koniec żądanie usługi używa parametrów związanych z tym punktem końcowym, by zawęzić wyświetlane dane.
Na przykład poniższe żądanie szczegółów dotyczące miejsca w przypadku elementów adresu działa w następujący sposób, zakładając, że zwrot jest w formacie JSON:
https://maps.googleapis.com/maps/api/place/details/json ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
W tym przypadku usługa korzysta z podanego identyfikatora miejsca, aby znaleźć żądane miejsce i zwrócić komponenty adresu w formacie JSON.
Zasoby
Poniższa tabela zawiera podsumowanie zasobów dostępnych przez interfejs API Miejsc Google, a także dane, które zostaną zwrócone.
Zasoby danych | Zwrócone dane | Format zwrotu |
---|---|---|
Wyszukiwanie miejsc | Zwraca listę miejsc na podstawie lokalizacji urządzenia lub ciągu wyszukiwania.
Zobacz informacje o odpowiedziach z wyszukiwarki, odpowiedziach z wyszukiwania w pobliżu i odpowiedziach z wyszukiwania tekstowego. |
|
Szczegóły miejsca | Zwraca bardziej szczegółowe informacje o konkretnym miejscu, w tym opinie użytkowników.
Szczegółowe informacje znajdziesz w sekcji Odpowiedzi na szczegóły miejsca. |
|
Miejsca | Zapewnia dostęp do milionów zdjęć związanych z miejscem przechowywanych w bazie danych Miejsc Google.
Więcej informacji znajdziesz w sekcji Odpowiedź na zdjęcie miejsca. |
|
Autouzupełnianie miejsc | Automatycznie wpisuje nazwę lub adres miejsca podczas wpisywania przez użytkowników.
Szczegółowe informacje znajdziesz w sekcji Umieszczanie odpowiedzi autouzupełniania. |
|
Autouzupełnianie zapytań | Zapewnia usługę przewidywania zapytań w przypadku tekstowych wyszukiwań geograficznych, które zwracają sugerowane zapytania podczas wpisywania przez użytkownika.
Szczegółowe informacje znajdziesz w sekcji Odpowiedzi na autouzupełnianie zapytań. |
|
Korzystanie z interfejsu Places API
Poniżej znajdziesz opis typowego scenariusza zastosowania 3 punktów końcowych w usłudze Miejsca API. Podczas tworzenia rozwiązania możesz używać dodatkowych punktów końcowych, takich jak wyszukiwanie w pobliżu, zdjęcia miejsca czy autouzupełnianie zapytań.1 | Konfiguracja | Zacznij od skonfigurowania projektu Google Cloud. Następnie wykonaj opisane poniżej czynności konfiguracyjne, aby dowiedzieć się, jak używać klucza interfejsu API. |
2 | Wyszukiwanie podstawowe według tekstu | Gdy uzyskasz klucz interfejsu API, wykonaj proste wyszukiwanie tekstu wskazane w artykule Podstawowe przykłady wyszukiwania tekstu w przewodniku Wyszukiwanie tekstu. |
3 | Korzystanie z żądania Znajdź miejsce | Prośby o znalezienie miejsc zwracają identyfikator miejsca wraz z Twoimi polami danych, takimi jak godziny otwarcia, adres i zdjęcia. Zapoznaj się z przykładami znajdowania miejsc i spróbuj zastosować jeszcze jeden, który najlepiej pasuje do Twojego przypadku użycia. |
4 | Podstawowe informacje o odpowiedziach w usłudze Znajdź miejsce | Eksplorowanie danych zwróconych przez odpowiedź Znajdź miejsce. Więcej informacji znajdziesz w sekcji Znajdowanie odpowiedzi na pytania o miejsca. |
5 | Aby poznać więcej szczegółów, użyj identyfikatora miejsca | Odpowiedzi dotyczące znajdowania miejsc nie obejmują wszystkich danych dostępnych dla wybranego miejsca. Aby uzyskać jeszcze więcej informacji o danym miejscu, możesz użyć identyfikatora miejsca zwróconego w odpowiedzi Znajdź miejsce. Zobacz Szczegóły miejsca. |
Dostępne biblioteki klienta
Wywołaj ten interfejs API w wybranym przez siebie języku za pomocą jednej z tych bibliotek klientów:
- Klient Java dla usług Map Google
- Klient Pythona dla usług Map Google
- Przejdź do klienta dla Usług Map Google
- Klient Node.js dla usług Map Google
Java Client, Python Client, Go Client i Node.js Client for Mapy Google to obsługiwane przez społeczność biblioteki klienta utworzone na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz również instrukcje instalacji i przykładowy kod.
Co dalej?
- Zacznij korzystać z wyszukiwania interfejsu Places API: otwórz wyszukiwanie miejsc.
- Wygeneruj klucz interfejsu API: przeczytaj artykuł Korzystanie z kluczy interfejsu API.