Dlaczego warto korzystać z interfejsu Places API?
Twórz funkcje zorientowane na lokalizację, aby łatwo udostępniać użytkownikom szczegółowe dane o lokalizacji. Dane dostępne przez Places API są oparte na jednym z najdokładniejszych, aktualnych i kompleksowych modeli miejsc rzeczywistego świata. Oto przykładowe zastosowania aplikacji:
- Wyświetlaj reklamy wynajmu mieszkań na dużych obszarach metropolitalnych z wynikami kierowanymi na miasta.
- Dołącz szczegółowe informacje o miejscu w aktualizacji stanu odbioru lub dostawy.
- Wyświetla listę parków w okolicy oraz zdjęcia i opinie przesłane przez użytkowników.
- Udostępniaj osobom planującym wyjazd informacje kontaktowe, opinie i poziomy cen pobliskich miejsc.
Do czego służy interfejs Places API
Za pomocą interfejsu Places API możesz uwzględnić w swoich aplikacjach te funkcje:
- Dostarcz wyniki wyszukiwania miejsc związane z różnymi typami zapytań użytkowników, takimi jak zapytania tekstowe, lokalizacje w pobliżu lub niejednoznaczne lub kategorialne zapytania użytkownika.
- Włącz funkcje autouzupełniania w przypadku różnych typów wyszukiwania – konkretnych zapytań tekstowych lub kategorialnych.
- Sprecyzuj rodzaj zwracanych informacji o miejscu, takich jak godziny otwarcia, podsumowanie, opinie użytkowników i zdjęcie.
- Dodawaj wysokiej jakości zdjęcia do lokalizacji obsługiwanych przez Twoją aplikację.
Wiele interfejsów API Google Maps Platform obsługuje identyfikatory miejsc, w przypadku których identyfikator 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 interfejsów Geocoding API, Routes API i Address Validation API.
Po uzyskaniu identyfikatora miejsca możesz użyć interfejsu Places API, by uzyskać więcej informacji o konkretnym obiekcie lub ciekawym miejscu, np. pełny adres, numer telefonu, oceny użytkowników i opinie.
Wybierz wersję interfejsu Places API
Interfejs Places API obsługuje 2 wersje: Places API to istniejące interfejsy API, a Places API (nowa wersja) to wersje nowej generacji.
Po wprowadzeniu nowego interfejsu Places API Twoim pierwszym zadaniem jest wybór zestawu interfejsów API, których chcesz użyć. Jeśli jesteś nowym lub obecnym klientem, który korzysta już z tych interfejsów API. Skorzystaj z tego przewodnika, aby poznać najważniejsze różnice między tymi dwoma interfejsami API.
Jak działa interfejs Places API
Places API (nowość)
Interfejs Places API (nowość) akceptuje żądania jako standardowy adres URL z określonym punktem końcowym usługi, np. /places lub places:searchText, i zwraca odpowiedź JSON. Interfejs Places API (nowość) obsługuje autoryzację za pomocą klucza interfejsu API i tokena OAuth.
Ten przykład tworzy żądanie dotyczące informacji o miejscu, które zwraca komponenty adresu dla identyfikatora miejsca przy użyciu klucza interfejsu API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Interfejs Places API akceptuje żądania jako standardowy URL z określonym punktem końcowym usługi, takim jak /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.
Ten przykład tworzy żądanie dotyczące informacji o miejscu, 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 używa 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 w interfejsie Places API.
| Places API | Places API (nowość) | Uwaga |
|---|---|---|
| Znajdź miejsce | Wyszukiwanie tekstowe (nowość) | Nie ma nowej wersji usługi Znajdź miejsce. Funkcja ta została zastąpiona przez funkcję wyszukiwania tekstowego (nową). |
| Wyszukiwanie w pobliżu | Wyszukiwanie w pobliżu (nowość) | Wszystkie żądania używające dotychczasowego interfejsu API, które zawierają zapytanie tekstowe, powinny korzystać z opcji Wyszukiwanie tekstowe (nowe), ponieważ Wyszukiwanie w pobliżu (nowość) nie obsługuje wprowadzania tekstu. |
| Wyszukiwanie tekstowe | Wyszukiwanie tekstowe (nowość) | |
| Szczegóły miejsca | Szczegóły miejsca (nowe) | |
| Zdjęcie miejsca | Zdjęcie miejsca (nowe) | |
| Autouzupełnianie miejsc | Autouzupełnianie (nowość) | |
| Autouzupełnianie zapytań | Autouzupełnianie (nowość) | Funkcje dodane do autouzupełniania (nowość) |
Jak korzystać z interfejsu Places API
Poniżej opisano typowy scenariusz użycia usługi Places API. W trakcie tworzenia rozwiązania możesz używać dodatkowych punktów końcowych, takich jak Wyszukiwanie w pobliżu i Zdjęcia miejsc.| 1 | Konfiguracja | Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane instrukcje konfiguracji, a potem dowiedz się, jak używać klucza interfejsu API. W przypadku interfejsu Places API (nowego) możesz też używać tokenów OAuth. |
| 2 | Wypróbuj podstawowe wyszukiwanie tekstu | Przeprowadź proste wyszukiwanie tekstowe za pomocą funkcji Wyszukiwanie tekstowe (nowość) lub Wyszukiwanie tekstowe. |
| 3 | Użyj identyfikatora miejsca, aby uzyskać więcej informacji | Wiele interfejsów Google Maps Platform API zwraca w odpowiedzi identyfikator miejsca. Aby uzyskać szczegółowe informacje o danym miejscu, użyj identyfikatora miejsca. Patrz Szczegóły miejsca (nowe) i Szczegóły miejsca. |
| 4 | Robienie zdjęć danego miejsca | Usługa Zdjęcia miejsc zapewnia dostęp do milionów zdjęć przechowywanych w bazie danych Miejsc. Użyj opcji Zdjęcie miejsca (nowe) lub Szczegóły miejsca, aby uzyskać dostęp do zdjęć danego miejsca. |