Przegląd

Interfejs Places API to usługa, która na różne sposoby akceptuje żądania HTTP dotyczące danych o lokalizacji. Zwraca sformatowane dane o lokalizacji i zdjęcia instytucji, lokalizacji geograficznych i ważnych ciekawych miejsc.

Dlaczego warto korzystać z interfejsu Places API

Twórz funkcje rozpoznające lokalizację, aby łatwo udostępniać użytkownikom szczegółowe dane o lokalizacji. Dane dostępne przez interfejs Places API są oparte na jednym z najbardziej dokładnych, aktualnych i kompleksowych modeli miejsc świata rzeczywistego. Oto przykładowe przypadki użycia aplikacji:

  • Wyświetlaj mieszkania na wynajem w dużych aglomeracjach z wynikami kierowanymi na miasta.
  • Dołącz szczegółowe informacje o miejscu w informacjach o stanie odbioru lub dostawy.
  • wyświetlać listę parków w pobliżu wraz ze zdjęciami i opiniami przesłanymi przez użytkowników;
  • Przekaż osobom planującym podróże informacje kontaktowe, opinie i informacje o poziomach cen danego obiektu.

Do czego służy interfejs Places API

Za pomocą interfejsu Places API możesz uwzględnić w swoich aplikacjach te funkcje:

  • Podaj wyniki wyszukiwania miejsc pochodzące z różnych typów zapytań użytkowników, np. wprowadzonych tekstu, lokalizacji w pobliżu oraz zapytań niejednoznacznych lub związanych z kategorią.
  • Włącz funkcje autouzupełniania dla różnych typów wyszukiwania – konkretnych zapytań tekstowych lub kategorii.
  • Doprecyzuj typ zwracanych informacji o miejscu, takich jak godziny otwarcia, podsumowanie, opinie użytkowników i zdjęcie.
  • Dodaj wysokiej jakości zdjęcia do lokalizacji obsługiwanych przez Twoją aplikację.

Wiele interfejsów API Google Maps Platform obsługuje identyfikatory miejsc, gdzie identyfikator miejsca jednoznacznie identyfikuje 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, a także za pomocą interfejsów Geocoding API, Routes API oraz Address Validation API.

Po uzyskaniu identyfikatora miejsca możesz skorzystać z interfejsu Places API, aby poprosić o szczegółowe informacje o danym obiekcie lub ciekawym miejscu, takie jak jego pełny adres, numer telefonu, ocena użytkowników i opinie.

Wybierz wersję interfejsu Places API

Interfejs Places API obsługuje 2 wersje interfejsu API: Places API to dotychczasowe interfejsy API, a Places API (nowy) to nowe wersje interfejsów API.

Po udostępnieniu nowego interfejsu Places API pierwsze zadanie to podjęcie decyzji, którego zestawu interfejsów API chcesz używać. Dotyczy to sytuacji, gdy jesteś nowym lub obecnym klientem korzystającym z interfejsów API. W tym przewodniku znajdziesz najważniejsze różnice między tymi 2 interfejsami API.

Jak działa interfejs Places API

Places API (nowość)

Interfejs Places API (nowy) akceptuje żą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ę według klucza interfejsu API i tokena OAuth. Z przykładu poniżej tworzymy żądanie informacji o miejscu, które za pomocą klucza interfejsu API zwraca komponenty adresu dla identyfikatora miejsca:

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

Places API

Interfejs Places API akceptuje żądania w postaci standardowego adresu URL z określonym punktem końcowym usługi, np. /place lub /photo. Punkty końcowe akceptują też typ formatu określony w żądaniu: JSON lub XML. Żądanie usługi używa parametrów odpowiednich dla tego konkretnego punktu końcowego, aby doprecyzować zwracane dane. Poniższy przykład tworzy żądanie szczegółów miejsca, które zwraca komponenty adresu dla identyfikatora miejsca w formacie JSON:

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0&fields=address_components&key=YOUR_API_KEY

W tej instancji usługa korzysta z podanego identyfikatora miejsca, aby znaleźć żądane miejsce i zwrócić komponenty adresu w formacie JSON.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pomocą interfejsu Places API.

Places API Places API (nowość) Uwaga
Znajdź miejsce Wyszukiwanie tekstowe (nowość) Nie ma nowej wersji aplikacji Znajdź miejsce. Wyszukiwanie tekstowe (nowe) zastąpiło tę funkcję.
Wyszukiwanie w pobliżu Wyszukiwanie w pobliżu (nowość) W przypadku wszystkich żądań korzystających z obecnego interfejsu API, które zawierają zapytanie tekstowe, należy użyć wyszukiwania tekstowego (nowa), ponieważ Wyszukiwanie w pobliżu (nowe) nie obsługuje wprowadzania tekstu.
Wyszukiwanie tekstowe Wyszukiwanie tekstowe (nowość)
Informacje o miejscu Szczegóły miejsca (nowość)
Zdjęcie miejsca Zdjęcie miejsca (nowe)
Autouzupełnianie miejsc Brak wersji interfejsu Places API (w nowej wersji)
Autouzupełnianie zapytań Brak wersji interfejsu Places API (w nowej wersji)

Jak korzystać z interfejsu Places API

Poniżej opisano typowy scenariusz 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 czy Zdjęcia miejsc.
1 Konfiguracja Zacznij od artykułu Skonfiguruj projekt Google Cloud i wykonaj podane instrukcje konfiguracji, a następnie dowiedz się, jak używać klucza interfejsu API. W przypadku interfejsu Places API (nowość) możesz też używać tokenów OAuth.
2 Wypróbuj podstawowe wyszukiwanie tekstu Przeprowadź proste wyszukiwanie tekstu za pomocą wyszukiwania (nowego) lub wyszukiwania tekstu.
3 Aby uzyskać więcej informacji, użyj identyfikatora miejsca Wiele interfejsów Google Maps Platform API zwraca w odpowiedzi identyfikator miejsca. Użyj identyfikatora miejsca, aby uzyskać szczegółowe informacje o miejscu. Zobacz Szczegóły miejsca (nowość) i Szczegóły miejsca.
4 Zdjęcia miejsca Usługa Zdjęcia miejsc zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Użyj zdjęcia miejsca (nowego) lub szczegółów miejsca, aby uzyskać dostęp do zdjęć tego miejsca.