Z tego dokumentu dowiesz się, jak używać interfejsu Nearby Search (New) API do tworzenia prostych i niedrogich
lokalnego odkrywania treści.
Funkcja odkrywania miejsc w pobliżu lokalizacji pokazuje użytkownikom najważniejsze interesujące miejsca w pobliżu wskazanych podczas wyszukiwania hotelu lub nieruchomości. Często składa się z interaktywnej mapy z dodatkowym panelem zawierającym selektor miejsc i galerię zdjęć. Poznasz różne produkty i funkcje Google Maps Platform, które zwiększają interaktywność.
Przykłady zastosowania
Dowiedzmy się teraz, które elementy integracji odkrywania lokalnego przyciągają użytkowników wartość:
Odkrywanie – wyświetlanie użytkownikom informacji o tym, co znajduje się w pobliżu danej lokalizacji, poprzez prezentowanie odpowiednich miejsc różnych typów.
Interaktywność – umożliwienie użytkownikom wybrania miejsca i dynamiczne odświeżanie danych.
względem tego miejsca.
Wizualizacja – udostępniaj opinie o miejscach i zdjęcia
oraz czas podróży pieszo i odległość, aby użytkownicy mogli szybko ocenić, do swoich potrzeb.
Architektura referencyjna
Wyszukiwanie lokalne
Istnieje wiele sposobów tworzenia lokalnych kart. Poniżej to niestandardowy przykład wygody użytkownika, który dobrze znane interfejsy API Google Maps Platform, a także kilka nowych, ciekawych funkcji. Jeśli chcesz stosować szablony do lokalnego wyszukiwania, możesz użyć Web Components.
Przykładowa aplikacja
Przykładowy przewodnik
W tabeli pod przykładową aplikacją znajdziesz podział na kroki wraz z opisem technicznej implementacji w Mapach Google Interfejsy API platformy.
1. Szukanie lokalizacji z autouzupełnianiemSzukaj lokalizacji
- Wczytaj Maps JavaScript API.
- Automatyczne uzupełnianie miejsc lub wybierz lokalizację na mapie.
2. Znajduj lokalne miejsca za pomocą interfejsu API Wyszukiwania w pobliżu (nowy)
- Ranking popularności (bardziej trafne wyniki) lub ranking odległości.
includedTypes
,excludedTypes
; jeśli prowadzisz hotel, możesz wykluczyć typ „lodging” i uwzględnić tylko odpowiednie typy, np. „restaurant, cafe, park, tourit_attraction”.- Aby uzyskać jeszcze większą kontrolę nad wynikami, użyj
includedPrimaryTypes
iexcludedPrimaryTypes
. - `locationRestriction, aby uniknąć niewystarczającej liczby wyników lub miejsc zbyt daleko od siebie; w przypadku braku wyników, poszerz okrąg / prostokąt przed wyświetleniem wyników.
Przykładowe zapytanie podczas rezerwacji hotelu z wymaganymi polami danych:
- Podstawowe (
displayName
,types
,openingHours
,formattedAddress
) - Kontakt (
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 wyświetlane podczas wyszukiwania nieruchomości z wymaganymi 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. Dodawanie interaktywności za pomocą interfejsu Dynamic Maps and Directions API
- Aktualne kroki i odcinki uzyskasz, wysyłając zapytanie do interfejsu API Trasy. * Wykorzystaj czas w następnej sekcji.
4. Wyświetl po interakcji szczegółowe informacje o miejscu
Opis:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Czas: na podstawie poprzedniego zapytania do interfejsu Directions API.
Opinie:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Obrazy: podczas korzystania z nieograniczonego podglądu interfejsu Topics API w pobliżu (nowego) możesz będzie musiała wysyłać zapytania dotyczące Miejsc Szczegóły z
place.id
, aby otrzymać photo_reference i zapytania po kolei,
Liczba zapytań i powiązane koszty
- JavaScript Map Interfejs API: 1 mapa podczas wczytywania eksperymentu.
- Autocomplete API miejsc: 1 zapytanie na każdy wpisany znak (jeśli używasz widżetu Autocomplete), można go dostosować.
- Wyszukiwanie w pobliżu (nowy) interfejs API: 1 zapytanie na każde 20 wyświetlanych miejsc. Różne metody płatności w zależności od danych miejsca, które są częścią odpowiedzi na zapytanie.
- Directions API: 1 zapytanie na każde miejsce wybrane przez użytkownika.
- Zdjęcie miejsca Interfejs API: 1 zapytanie dotyczące każdego wyświetlonego zdjęcia.
Podsumowanie
Lokalne wyszukiwanie to skuteczny sposób na zapewnienie użytkownikom wartości. Ten przykładowej implementacji ma wiele funkcji, które prawdopodobnie będzie można uwzględnić w Google Maps Platform dzięki specjalnym funkcjom z interfejsu API Wyszukiwanie w pobliżu (nowy) .
Następne kroki
Sugerowane materiały do dalszego zapoznania się z tematem:
- Komponenty internetowe w interfejsie Maps JavaScript API
- Optymalizacja autouzupełniania w Miejscach
- Inne usługi Miejsc
- Poniżej możesz zostawić opinię.
Współtwórcy
Główni autorzy:
Thomas Anglaret | Inżynier ds. rozwiązań platformowych w Google Maps