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 za pośrednictwem interfejsu Places API są oparte na jednym z najdokładniejszych, aktualnych i kompleksowe modele miejsc rzeczywistego. 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 swoim panelu te funkcje: aplikacje:
- Dostarcz wyniki wyszukiwania miejsc oparte na różnych typach zapytań użytkowników, takich jak wprowadzanie tekstu, lokalizacji w pobliżu oraz niejednoznacznych lub kategorialnych zapytań użytkowników.
- Włącz funkcje autouzupełniania dla różnych typów wyszukiwania (konkretnych zapytań tekstowych) lub kategorycznych.
- 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ę.
Obsługa wielu interfejsów Google Maps Platform API identyfikator miejsca, gdzie unikalny identyfikator miejsca. 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żna użyć interfejsu Places API, by poprosić o dodatkowe informacje na temat daną placówkę lub ciekawe miejsce, na przykład jej pełny adres, numer telefonu, oceny użytkowników i opinie użytkowników.
Wybierz wersję interfejsu Places API
Interfejs Places API obsługuje dwie wersje: Interfejs Places API to istniejące interfejsy API oraz Places API (Nowe) to nowe wersje interfejsów API.
Po wprowadzeniu nowego interfejsu Places API Twoim pierwszym zadaniem jest określenie, z zestawem interfejsów API, które mają być używane. Jeśli jesteś nowym lub obecnym klientem klient już korzysta z interfejsów API. Używaj w tym przewodniku, różnice między tymi dwoma interfejsami API.
Jak działa interfejs Places API
Places API (nowość)
Interfejs Places API (nowość) akceptuje żądania jako standardowe adresy URL z określonym
punkt końcowy usługi, taki jak /places lub places:searchText
i zwraca odpowiedź JSON. Places API (nowość) obsługuje autoryzację przez
klucz interfejsu API i token OAuth.
Następujący przykład wysyła żądanie dotyczące informacji o miejscu, które zwraca komponenty adresu dla
identyfikator miejsca za pomocą klucza interfejsu API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Interfejs Places API akceptuje żądania jako standardowe adresy URL z określonym
punkt końcowy usługi, taki jak /place lub /photo. Dodatkowo punkty końcowe
akceptuje typ formatu określony w żądaniu – JSON lub XML. Usługa
używa parametrów związanych z tym konkretnym punktem końcowym w celu doprecyzowania zwracanych danych.
Następujący przykład wysyła żądanie dotyczące informacji o miejscu, które zwraca komponenty adresu dla
identyfikator 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 tym przypadku usługa używa podanego identyfikatora miejsca do znalezienia żądanego miejsca. zwraca komponenty adresu w formacie JSON.
Zasoby
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w 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 korzystające z dotychczasowego interfejsu API, które zawierają zapytanie tekstowe, powinny używać tego interfejsu. Wyszukiwanie tekstowe (nowość) 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ązanie, możesz używać dodatkowych punktów końcowych, takich jak Wyszukiwarka w pobliżu czy Zdjęcia miejsc.| 1 | Konfiguracja | Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane instrukcje konfiguracji. dowiedz się, jak używać klucza interfejsu API. W przypadku interfejsu Places API (nowego) możesz również użyć Tokeny 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. Użyj identyfikator miejsca, aby uzyskać szczegółowe informacje o nim. 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 Miejscach Google w bazie danych. Użyj opcji Zdjęcie miejsca (nowe). lub Szczegóły miejsca w celu uzyskania dostępu do zdjęć danego miejsca. |