Z tego dokumentu dowiesz się, jak używać interfejsu Wyszukiwanie w pobliżu (New) API do tworzenia prostych i opłacalnych
lokalnych odkryć.
Funkcja odkrywania lokalnych miejsc pokazuje użytkownikom najważniejsze miejsca w pobliżu lokalizacji określonej podczas wyszukiwania hotelu lub nieruchomości. Często składa się z interaktywnej mapy z dodatkowym panelem zawierającym informacje o miejscu i galerię zdjęć. Poznasz różne usługi i funkcje Google Maps Platform, które pozwolą Ci zwiększyć interaktywność.

Przypadki użycia
Przyjrzyjmy się teraz elementom integracji z lokalnymi usługami odkrywania, które zwiększają wartość dla użytkowników:
Odkrywanie – przedstaw użytkownikom przegląd tego, co znajduje się wokół danej lokalizacji, wyświetlając odpowiednie miejsca różnych typów.
Interaktywność – umożliwia użytkownikom wybieranie miejsca i dynamiczne odświeżanie danych.
względem tego miejsca.
Wizualizacja – dodawanie opinii o miejscach i zdjęć
oraz czas i odległość do przejścia, aby użytkownicy mogli szybko ocenić, czy dana opcja im odpowiada.
Architektura referencyjna

Odkrywanie miejsc w pobliżu
Istnieje wiele sposobów na stworzenie lokalnego środowiska odkrywania. Poniższa integracja to niestandardowy przykład interfejsu użytkownika, który wykorzystuje dobrze znane interfejsy API Google Maps Platform oraz kilka nowych, ciekawych funkcji. Jeśli chcesz zastosować szablonowe podejście do lokalnego wykrywania, możesz użyć komponentów internetowych.
Przykładowa aplikacja
Przykładowy przewodnik
W tabeli poniżej znajdziesz przykładową aplikację podzieloną na etapy wraz z opisem implementacji technicznej z interfejsami API Google Maps Platform.
1. Wyszukiwanie lokalizacji z autouzupełnianiem
- Wczytaj Maps JavaScript API.
- zapytanie autouzupełniania miejsc lub wybierz lokalizację na mapie.

2. Wyświetlanie lokalnych ciekawych miejsc za pomocą interfejsu Wyszukiwanie w pobliżu (New) API
- ranking popularności (trafniejsze wyniki) lub ranking odległości.
includedTypes,excludedTypes; jeśli jesteś właścicielem hotelu, możesz wykluczyć typ „lodging” i uwzględnić tylko odpowiednie typy, np. „restaurant, cafe, park, tourist_attraction”.- Wykorzystaj
includedPrimaryTypes,excludedPrimaryTypes, aby mieć jeszcze większą kontrolę nad wynikami. - `locationRestriction, aby uniknąć niewystarczającej liczby wyników lub zbyt odległych miejsc. Jeśli nie ma żadnych wyników, przed wyświetleniem wyników zwiększ rozmiar okręgu lub prostokąta.

Przykładowe zapytanie dotyczące rezerwacji hotelu z wymaganymi polami danych:
- Podstawowy (
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 podczas wyszukiwania nieruchomości z żądaniem pól danych:
- Podstawowy (
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ść dzięki interfejsom Mapy dynamiczne API i Directions API.
- Aktualne etapy i kroki dzięki wysyłaniu zapytań do Directions API. * Użyj czasu w następnej sekcji.

4. Wyświetlanie szczegółowych informacji o miejscu po interakcji
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.Zdjęcia: podczas nieograniczonej wersji testowej interfejsu Wyszukiwanie w pobliżu (New) API musisz wysłać zapytanie do informacji o miejscu z parametrem
place.id, aby uzyskać photo_reference, a następnie wysyłać zapytania pojedynczo w swojej aplikacji.

Liczba zapytań i powiązane koszty
- Maps JavaScript API: 1 mapa przy wczytywaniu.
- Places Autocomplete API: 1 zapytanie na każdy wpisany znak (jeśli używasz widżetu autouzupełniania miejsc), można to dostosować.
- Interfejs API wyszukiwania w pobliżu (nowy): 1 zapytanie na każde 20 wyświetlonych miejsc. Różne rozliczenia w zależności od danych o miejscu, 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
Funkcja odkrywania lokalnych treści to skuteczny sposób na dostarczanie użytkownikom wartościowych informacji. Ta implementacja demonstracyjna ma wiele funkcji, które prawdopodobnie uwzględnisz podczas tworzenia takiego rozwiązania w Google Maps Platform, korzystając ze specjalnych możliwości interfejsu Wyszukiwanie w pobliżu (New) API .
Następne kroki
Sugerowane artykuły:
- 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 ds. rozwiązań Google Maps Platform