W skrócie

Interfejs Places API to usługa akceptująca żądania HTTP dotyczące danych o lokalizacji za pomocą różnych metod. Zwraca w nim sformatowane dane o lokalizacji i zdjęcia miejsc, obiektów geograficznych i ważnych miejsc.

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.

  • JSON
  • XML
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.

  • JSON
  • XML
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.

  • JSON
  • XML
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.

  • JSON
  • XML
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ń.

  • JSON
  • XML

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:

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?