Z tego dokumentu dowiesz się, jak używać interfejsu Wyszukiwanie w pobliżu (New) API do tworzenia prostych i ekonomicznych
lokalnych treści w sekcji Odkrywanie.
Lokalne treści w sekcji Odkrywanie pokazują użytkownikom najważniejsze ciekawe miejsca w pobliżu lokalizacji, którą określają podczas wyszukiwania hotelu lub nieruchomości. Często składają się one z interaktywnej mapy i dodatkowego panelu zawierającego informacje o miejscu oraz galerię zdjęć. Poznasz różne usługi i funkcje Google Maps Platform, które pozwolą Ci zwiększyć interaktywność.

Przypadki użycia
Teraz dowiedzmy się, które elementy integracji lokalnych treści w sekcji Odkrywanie zwiększają wartość dla użytkownika:
Odkrywanie – wyświetlaj użytkownikom przegląd tego, co znajduje się w pobliżu danej lokalizacji poprzez pokazywanie odpowiednich miejsc różnych typów.
Interaktywność – umożliwiaj użytkownikom wybieranie miejsca i dynamiczne odświeżanie danych
względem tego miejsca.
Wizualizacja – udostępniaj użytkownikom opinie o miejscach, zdjęcia
oraz czas i odległość do przejścia pieszo, aby mogli szybko sprawdzić, czy dane miejsce spełnia ich potrzeby.
Architektura referencyjna

Odkrywanie miejsc w pobliżu
Istnieje wiele sposobów na tworzenie lokalnych treści w sekcji Odkrywanie. Poniższa integracja to niestandardowy przykład wrażeń użytkownika, który wykorzystuje znane interfejsy Google Maps Platform API oraz kilka nowych, ciekawych funkcji. Jeśli chcesz użyć szablonu do tworzenia lokalnych treści w sekcji Odkrywanie, możesz skorzystać z komponentów internetowych.
Przykładowa aplikacja
Przewodnik po przykładzie
W tabeli poniżej znajdziesz przykładową aplikację podzieloną na etapy oraz opis implementacji technicznej za pomocą interfejsów Google Maps Platform API.
1. Wyszukiwanie lokalizacji z autouzupełnianiemWyszukaj lokalizację
- Wczytaj Maps JavaScript API.
- Wpisz zapytanie w Places Autocomplete lub wybierz lokalizację na mapie.

2. Wyświetlaj lokalne ciekawe miejsca za pomocą Nearby Search (New) API
- Ranking popularności (trafniejsze wyniki) lub ranking odległości.
includedTypes,excludedTypes; jeśli masz hotel, możesz wykluczyć typ „lodging” i uwzględnić tylko odpowiednie typy, np. „restaurant, cafe, park, tourist_attraction”.- Aby mieć jeszcze większą kontrolę nad wynikami, użyj
includedPrimaryTypes,excludedPrimaryTypes. - `locationRestriction`, aby uniknąć niewystarczającej liczby wyników lub miejsc zbyt oddalonych; jeśli nie ma żadnych wyników, przed ich wyświetleniem powiększ rozmiar okręgu lub prostokąta.

Przykładowe zapytanie podczas rezerwacji hotelu z żądanymi polami danych:
- Podstawowe (
displayName,types,openingHours,formattedAddress) - Kontaktowe (
websiteUri,nationalPhoneNumber,internationalPhoneNumber) - Preferowane (
reviews,priceLevel,userRatingCount)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }Przykładowe zapytanie podczas wyszukiwania nieruchomości z żądanymi polami danych:
- Podstawowe (
displayName,types,openingHours,formattedAddress)
{ "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }3. Dodaj interaktywność za pomocą Dynamic Maps i Directions API
- Aktualne trasy i kroki dzięki zapytaniom do Directions API. * W następnej sekcji użyj czasu.

4. Wyświetlaj szczegółowe informacje o miejscu po interakcji
Opis:
displayName,types,rating,userRatingCount,priceLevel.Czas: pochodzi z poprzedniego zapytania do Directions API.
Opinie:
reviews[i].author,reviews[i].rating,reviews[i].text.Obrazy: podczas nieograniczonego podglądu Wyszukiwania w pobliżu (New) API musisz wysłać zapytanie do Places Details z
place.idaby uzyskać photo_reference a następnie wysłać zapytanie o każdy z nich w swoim projekcie.

Liczba zapytań i powiązane koszty
- Maps JavaScript API: 1 mapa podczas wczytywania treści.
- Places Autocomplete API: 1 zapytanie na każdy wpisany znak (jeśli używasz widżetu autouzupełniania), można je dostosować.
- Wyszukiwanie w pobliżu (Nowe) API: 1 zapytanie na każde 20 wyświetlanych miejsc. Różne rozliczenia w zależności od danych o miejscach , które są częścią odpowiedzi na zapytanie.
- Directions API: 1 zapytanie na każde miejsce wybrane przez użytkownika.
- Place Photo API: 1 zapytanie na każde wyświetlane zdjęcie.
Podsumowanie
Lokalne treści w sekcji Odkrywanie to skuteczny sposób na zwiększenie wartości dla użytkownika. Ta demonstracyjna implementacja ma wiele funkcji, które prawdopodobnie uwzględnisz podczas tworzenia takich treści w Google Maps Platform, korzystając ze specjalnych funkcji z Nearby Search (New) API .
Następne kroki
Sugerowane dalsze lektury:
- Komponenty internetowe w Maps JavaScript API
- Optymalizacja autouzupełniania miejsc
- Inne usługi Places
- Prześlij opinię poniżej.
Współtwórcy
Główni autorzy:
Thomas Anglaret | Inżynier rozwiązań Google Maps Platform