Z tego dokumentu dowiesz się, jak korzystać z interfejsu API wyszukiwania w pobliżu (Nowy) do tworzenia prostych i niedrogich
lokalnych treści w sekcji Odkrywanie.
Funkcja odkrywania lokalizacji wyświetla użytkownikom najważniejsze miejsca w pobliżu wybranej przez nich lokalizacji 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 pozwolą Ci zwiększyć interaktywność.
Przykłady zastosowania
Dowiedzmy się teraz, które elementy integracji odkrywania lokalnego wpływają na wartość użytkownika:
Odkrywanie – daj użytkownikom przegląd tego, co znajduje się w pobliżu wybranej lokalizacji, wyświetlając odpowiednie miejsca 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 i odległość, aby użytkownicy mogli szybko sprawdzić, czy to miejsce odpowiada ich potrzebom.
Architektura referencyjna
Odkrywanie lokalne
Istnieje wiele sposobów na tworzenie lokalnych kart. Poniżej znajduje się niestandardowy przykład interfejsu użytkownika wykorzystującego 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ć WebComponents.
Przykładowa aplikacja
Przykładowy przewodnik
W tabeli poniżej znajdziesz przykładową aplikację z podziałem na kroki oraz opis technicznej implementacji za pomocą interfejsów Google Maps Platform API.
1. Szukanie lokalizacji z autouzupełnianiemWyszukiwanie lokalizacji
- Wczytaj Maps JavaScript API.
- Autouzupełnianie miejsc lub wybierz lokalizację na mapie.
2. Znajduj lokalne miejsca za pomocą interfejsu API wyszukiwania w pobliżu (nowy)
- popularności (bardziej trafne wyniki) lub odległości.
includedTypes
,excludedTypes
. Jeśli prowadzisz hotel, możesz wykluczyć typ „kwatery” i uwzględnić tylko odpowiednie typy obiektów, np. „restauracja, kawiarnia, park, atrakcja_turystyczna”.- 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ład zapytania 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ład zapytania 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 API Mapy dynamiczne i Skierowania
- Aktualne kroki i odcinki można uzyskać, wysyłając zapytanie do interfejsu API Trasy. * Użyj czasu w następnej sekcji.
4. wyświetlać szczegółowe informacje o miejscu po interakcji z nim;
Opis:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Time: pochodzi z poprzedniego zapytania do interfejsu Directions API.
Opinie:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Obrazy: w ramach wersji próbnej interfejsu API wyszukiwania w pobliżu (nowej) bez ograniczeń musisz wysłać zapytanie do szczegółów
place.id
, aby uzyskać photo_reference, a potem wysłać zapytanie do jednego z nich.
Liczba zapytań i powiązane z nimi koszty
- Maps JavaScript API: 1 mapa podczas wczytywania interfejsu.
- 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.
- Place Photo API: 1 zapytanie na każde wyświetlone zdjęcie.
Podsumowanie
Lokalne odkrywanie produktów to skuteczny sposób na zwiększenie wartości dla użytkowników. Ta demonstracyjna implementacja ma wiele funkcji, które prawdopodobnie będzie można uwzględnić podczas tworzenia takiego środowiska w Google Maps Platform ze specjalnymi funkcjami dostępnymi w interfejsie API wyszukiwania w pobliżu (nowy) .
Następne kroki
Sugerowane materiały do dalszego zapoznania się z tematem:
- Komponenty sieciowe w Maps JavaScript API
- Optymalizacja autouzupełniania w Places
- Inne Usługi Miejsca
- Zostaw opinię poniżej.
Współtwórcy
Główni autorzy:
Thomas Anglaret | Inżynier ds. rozwiązań platformowych w Google Maps