Przegląd
Google Maps Platform jest dostępna w przypadku aplikacji internetowych (JS, TS) oraz aplikacji na Androida i iOS. Oferuje też interfejsy API usług internetowych, które umożliwiają uzyskiwanie informacji o miejscach, wskazówkach dojazdu i odległościach. Przykłady w tym przewodniku są przeznaczone na jedną platformę, ale podajemy linki do dokumentacji dotyczącej implementacji na innych platformach.
Gdy użytkownicy widzą Twoje produkty online, chcą znaleźć najlepszy i najwygodniejszy sposób na otrzymanie zamówienia. Przewodnik po implementacji lokalizatora produktów i wskazówki dotyczące dostosowywania to zalecane przez Google optymalne połączenie interfejsów API Google Maps Platform, które pozwala tworzyć świetne lokalizatory produktów.
Dzięki temu przewodnikowi po implementacji możesz pomóc klientom zobaczyć szczegółowe informacje, których potrzebują, aby znaleźć Twoje produkty, i podać im wskazówki dojazdu do sklepu, w którym znajduje się dany produkt, niezależnie od tego, czy jadą samochodem, rowerem, idą pieszo czy korzystają z transportu publicznego.
Włącz interfejsy API
Aby wdrożyć lokalizator produktów, musisz włączyć te interfejsy API w konsoli Google Cloud. Te hiperlinki przekierują Cię do konsoli Google Cloud, gdzie możesz włączyć poszczególne interfejsy API w wybranym projekcie:
Więcej informacji o konfiguracji znajdziesz w artykule Pierwsze kroki w Google Maps Platform.
Sekcje przewodnika po implementacji
W tym artykule opisujemy te implementacje i dostosowania:
- Ikona znacznika wyboru to podstawowy krok implementacji.
- Ikona gwiazdki to opcjonalny, ale zalecany element dostosowywania, który ulepsza rozwiązanie.
| Powiąż lokalizacje sklepów z miejscami na Google Maps Platform | Dopasuj lokalizację sklepu do miejsca w Google Maps Platform. | |
| Identyfikowanie lokalizacji użytkownika | Dodaj funkcję wpisywania na bieżąco, aby poprawić wrażenia użytkowników na wszystkich platformach i zwiększyć dokładność adresów przy minimalnej liczbie naciśnięć klawiszy. | |
| Znajdowanie najbliższych sklepów | Obliczaj odległość i czas podróży dla wielu punktów początkowych i docelowych, opcjonalnie określając różne formy transportu, takie jak pieszo, samochodem, transportem publicznym lub rowerem. | |
| Wyświetlanie informacji o sklepie | Wyświetlaj szczegółowe informacje o swoich sklepach, aby ułatwić użytkownikom dotarcie do nich. | |
| podawanie wskazówek nawigacyjnych, | Uzyskuj dane o trasie z miejsca początkowego do miejsca docelowego przy użyciu różnych środków transportu, takich jak pieszo, samochodem, rowerem i transportem publicznym. | |
| Wysyłanie trasy na urządzenie mobilne | Oprócz wyświetlania wskazówek dojazdu na stronie internetowej możesz też wysyłać je na telefon użytkownika, aby mógł korzystać z nawigacji w Mapach Google, gdy jest w drodze. | |
| Wyświetlanie lokalizacji na interaktywnej mapie | Twórz niestandardowe znaczniki mapy, aby wyróżnić swoje lokalizacje, i dostosuj styl mapy do kolorów swojej marki. Wyświetlaj (lub ukrywaj) na mapie określone ciekawe miejsca, aby ułatwić użytkownikom orientację, i kontroluj ich zagęszczenie, aby uniknąć bałaganu na mapie. | |
| Łączenie niestandardowych danych o lokalizacji z informacjami o miejscu | Połącz własne niestandardowe informacje o lokalizacji z informacjami o miejscu, aby zapewnić użytkownikom bogaty zestaw danych ułatwiający podejmowanie decyzji. |
Powiąż lokalizacje sklepów z miejscami w Google Maps Platform
Uzyskiwanie identyfikatorów miejsc
| Ten przykład korzysta z: Places API (nowość) | Dostępne też w: JavaScript |
Załóżmy, że masz bazę danych swoich sklepów z podstawowymi informacjami, takimi jak nazwa lokalizacji, jej adres i numer telefonu, i chcesz powiązać ją z miejscem w Google Maps Platform jako zestawem miejsc docelowych, w których użytkownicy mogą odbierać produkty. Aby pobrać informacje, które Google Maps Platform ma o danym miejscu, w tym współrzędne geograficzne i informacje przesłane przez użytkowników, znajdź identyfikator miejsca, który odpowiada każdemu ze sklepów w Twojej bazie danych. Możesz wywołać
punkt końcowy Wyszukaj tekst (New) w Places API (New) i poprosić tylko o pole places.id w masce pola (co spowoduje aktywowanie SKU Wyszukaj tekst Essentials IDs Only).
Poniżej znajdziesz przykład żądania identyfikatora miejsca dla biura Google w Londynie:
curl -X POST -d '{
"textQuery" : "Google London"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'Możesz zapisać ten identyfikator miejsca w bazie danych wraz z pozostałymi danymi sklepu i używać go jako skutecznego sposobu na uzyskiwanie informacji o sklepie. Poniżej znajdziesz instrukcje używania identyfikatora miejsca do geokodowania, pobierania informacji o miejscu i uzyskiwania wskazówek dojazdu do miejsca.
Geokodowanie lokalizacji
| Ten przykład korzysta z: Geocoding API | Dostępne też w: JavaScript |
Jeśli Twoja baza danych sklepów zawiera adresy, ale nie zawiera współrzędnych geograficznych, użyj interfejsu Geocoding API, aby uzyskać szerokość i długość geograficzną danego adresu i obliczyć, które sklepy znajdują się najbliżej klienta. Możesz zakodować geograficznie sklep po stronie serwera, zapisać szerokość i długość geograficzną w bazie danych i odświeżać je co najmniej raz na 30 dni.
Oto przykład użycia interfejsu Geocoding API do uzyskania szerokości i długości geograficznej identyfikatora miejsca zwróconego dla biura Google w Londynie:
```html
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU&key=YOUR_API_KEY&solution_channel=GMP_guides_productlocator_v1_a
```
Identyfikowanie lokalizacji użytkownika
| Ten przykład korzysta z: Autouzupełniania miejsc w Maps JavaScript API | Dostępne też na: Android | iOS |
Kluczowym elementem lokalizatora produktów jest określenie lokalizacji początkowej użytkownika. Możesz zaoferować użytkownikowi 2 opcje określenia lokalizacji początkowej: wpisanie miejsca rozpoczęcia wyszukiwania lub przyznanie uprawnień do geolokalizacji w przeglądarce lub usługach lokalizacyjnych na urządzeniu mobilnym.
Obsługa wpisów wpisywanych za pomocą autouzupełniania
Dzisiejsi użytkownicy są przyzwyczajeni do funkcji autouzupełniania w konsumenckiej wersji Map Google. Tę funkcję można zintegrować z dowolną aplikacją za pomocą bibliotek Miejsc Google Maps Platform na urządzeniach mobilnych i w internecie. Gdy użytkownik wpisuje adres, autouzupełnianie wypełnia resztę za pomocą widżetów. Możesz też udostępnić własną funkcję autouzupełniania, korzystając bezpośrednio z interfejsu Place Autocomplete Data API.
W poniższym przykładzie dodaj do witryny biblioteki Miejsca i Znacznik, dodając parametr libraries=places,marker do adresu URL skryptu interfejsu Maps JavaScript API.
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places,marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a" defer></script>Następnie dodaj do strony element kontenera, do którego zostanie dołączony widżet PlaceAutocompleteElement:
<div id="autocomplete-container"></div>Na koniec zainicjuj widżet PlaceAutocompleteElement i dołącz go do kontenera. Ograniczenie podpowiedzi autouzupełniania miejsc za pomocą includedPrimaryTypes: ["geocode"] konfiguruje widżet tak, aby akceptował adresy, dzielnice, miasta i kody pocztowe, dzięki czemu użytkownicy mogą podać dowolny poziom szczegółowości, aby opisać swoje miejsce początkowe. Gdy użytkownik wybierze podpowiedź, zostanie wywołane zdarzenie gmp-select i będzie można wywołać place.fetchFields(), aby poprosić o pole location zawierające szerokość i długość geograficzną miejsca, z którego użytkownik rozpoczyna podróż. Za pomocą tych współrzędnych mapy możesz wskazać relację między lokalizacjami a punktem początkowym.
// Create the PlaceAutocompleteElement, restricting predictions to // geographical location types in the United Kingdom. const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement({ includedPrimaryTypes: ["geocode"], includedRegionCodes: ["gb"], }); placeAutocomplete.placeholder = "Enter starting address, city, or zip code"; document.getElementById("autocomplete-container").appendChild(placeAutocomplete); // When the user selects an address from the drop-down, // fetch the place details and search for the nearest stores. placeAutocomplete.addEventListener("gmp-select", async ({ placePrediction }) => { const place = placePrediction.toPlace(); await place.fetchFields({ fields: ["id", "location", "formattedAddress"], }); searchFromOrigin(place); }); }
W tym przykładzie po wybraniu adresu przez użytkownika uruchamia się funkcja searchFromOrigin(). Pobiera lokalizację dopasowanego wyniku, czyli lokalizację użytkownika, a następnie wyszukuje najbliższe lokalizacje na podstawie tych współrzędnych jako punktu początkowego, co zostało omówione w sekcji Identyfikowanie najbliższych sklepów.
Rozwiń tę sekcję, aby zobaczyć filmy instruktażowe dotyczące dodawania autouzupełniania miejsc do aplikacji:
Witryna
Aplikacje na Androida
Aplikacje na iOS
Użyj geolokalizacji przeglądarki
Aby poprosić o geolokalizację przeglądarki HTML5 i ją obsłużyć, dowiedz się, jak włączyć okno Użyj mojej lokalizacji:
znajdowanie najbliższych sklepów,
| Ten przykład korzysta z: biblioteki tras, Maps JavaScript API | Dostępny jest też: Routes API |
Gdy poznasz lokalizację użytkownika, możesz ją porównać z lokalizacjami swoich sklepów. Możesz to zrobić za pomocą klasy RouteMatrix w bibliotece Routes Library, Maps JavaScript API (lub funkcji Compute Route Matrix w interfejsie Routes API). Dzięki temu użytkownicy będą mogli wybrać lokalizację, która jest dla nich najwygodniejsza pod względem czasu dojazdu lub odległości drogowej.
Standardowym sposobem porządkowania listy lokalizacji jest sortowanie ich według odległości. Często odległość ta jest obliczana w linii prostej od użytkownika do lokalizacji, ale może to być mylące. Linia prosta może przebiegać przez rzekę, której nie da się przekroczyć, lub przez ruchliwe drogi, podczas gdy inna lokalizacja może być wygodniejsza. Jest to ważne, gdy masz kilka lokalizacji w odległości kilku kilometrów od siebie.
Metoda RouteMatrix.computeRouteMatrix pobiera listę lokalizacji początkowych i docelowych, a następnie zwraca nie tylko odległość, ale też czas podróży między nimi. W przypadku użytkownika miejscem początkowym będzie jego bieżąca lokalizacja lub wybrany punkt początkowy, a miejscami docelowymi będą lokalizacje. Miejsca początkowe i docelowe można określić jako pary współrzędnych, identyfikatory miejsc lub adresy. Możesz użyć RouteMatrix.computeRouteMatrix z ustawieniami trasy, takimi jak TRAFFIC_AWARE, aby wyświetlać wyniki na podstawie bieżącego lub przyszłego czasu jazdy.
Poniższy przykład wywołuje funkcję RouteMatrix.computeRouteMatrix w bibliotece tras Maps JavaScript API, określając miejsce rozpoczęcia podróży użytkownika i maksymalnie 25 lokalizacji sklepów jednocześnie.
async function getDistances(originLocation) { const { RouteMatrix } = await google.maps.importLibrary("routes"); const request = { origins: [originLocation], destinations: stores.slice(0, 25).map((store) => store.location), travelMode: google.maps.TravelMode.DRIVING, routingPreference: "TRAFFIC_AWARE", fields: ["distanceMeters", "durationMillis", "condition"], }; return RouteMatrix.computeRouteMatrix(request); } function update(location) { if (!location) { return; } // ... // sort by spherical distance stores.sort((a, b) => { return ( google.maps.geometry.spherical.computeDistanceBetween( new google.maps.LatLng(a.location), location ) - google.maps.geometry.spherical.computeDistanceBetween( new google.maps.LatLng(b.location), location ) ); }); // display travel distance and time getDistances(location) .then(({ matrix }) => { const items = matrix.rows[0].items; for (let i = 0; i < items.length; i++) { if (items[i].condition === "ROUTE_EXISTS") { stores[i].travelDistance = items[i].distanceMeters; stores[i].travelDuration = items[i].durationMillis; } } }) .finally(() => { renderCards(stores); autocompleteInput.disabled = false; isUpdateInProgress = false; }); }
W przypadku każdej lokalizacji w pobliżu możesz wyświetlić stan zapasów produktu na podstawie bazy danych asortymentu.
Wyświetlanie informacji o sklepie
| Ten przykład korzysta z: biblioteki Miejsc, Maps JavaScript API | Dostępne są też: Places SDK for Android | Places SDK for iOS | Places API (New) |
Możesz udostępniać szczegółowe informacje o miejscu, takie jak dane kontaktowe, godziny otwarcia i aktualny stan otwarcia, aby pomóc klientom wybrać preferowaną lokalizację lub sfinalizować zamówienie.
Po wywołaniu interfejsu Maps JavaScript API w celu uzyskania szczegółowych informacji o miejscu możesz przefiltrować i wyrenderować odpowiedź.
Aby poprosić o informacje o miejscu, musisz mieć identyfikator miejsca każdej ze swoich lokalizacji. Aby uzyskać identyfikator miejsca, zapoznaj się z artykułem Pobieranie identyfikatorów miejsc.
Poniższe żądanie informacji o miejscu używa klasy Place, aby zwrócić nazwę, współrzędne, witrynę, numer telefonu, ocenę i godziny otwarcia miejsca o identyfikatorze miejsca Google London:
const place = new google.maps.places.Place({ id: 'ChIJVSZzVR8FdkgRTyQkxxLQmVU', });await place.fetchFields({ fields: [ 'displayName', 'nationalPhoneNumber', 'location', 'regularOpeningHours', 'rating', 'utcOffsetMinutes', 'websiteURI', ], });
createMarker(place);
Ulepszanie lokalizatora produktów
W zależności od potrzeb firmy lub użytkowników możesz dodatkowo ulepszyć wrażenia użytkownika.
wyznaczanie trasy,
| Ten przykład korzysta z: biblioteki tras, Maps JavaScript API | Dostępna jest też usługa internetowa Routes API do użytku na urządzeniach z Androidem i iOS, bezpośrednio z aplikacji lub zdalnie przez serwer proxy. |
Gdy pokazujesz użytkownikom wskazówki dojazdu w swojej witrynie lub aplikacji, nie muszą oni opuszczać Twojej witryny i rozpraszać się innymi stronami ani widzieć konkurencji na mapie. Za pomocą interfejsu Routes API możesz też prosić o trasy przyjazne dla środowiska, aby oszacować zużycie paliwa lub energii i pokazać wpływ podróży na środowisko.
Klasa Route w bibliotece tras interfejsu Maps JavaScript API zawiera też metody takie jak createPolylines() i createWaypointAdvancedMarkers(), które umożliwiają przetwarzanie wyników i wyświetlanie ich na mapie.
Poniżej znajdziesz przykład żądania i wyświetlania trasy na mapie. Więcej informacji o przykładzie znajdziesz w artykule Wyznaczanie trasy.
Wysyłanie trasy na urządzenie mobilne
Aby ułatwić użytkownikom dotarcie do lokalizacji, możesz wysłać im SMS-em lub e-mailem link do wskazówek dojazdu. Gdy klikną link, na ich telefonie uruchomi się aplikacja Mapy Google (jeśli jest zainstalowana) lub w przeglądarce na urządzeniu otworzy się strona maps.google.com. W obu przypadkach użytkownik może skorzystać ze szczegółowych wskazówek dojazdu, w tym wskazówek głosowych, aby dotrzeć do celu.
Użyj
adresów URL Map, aby utworzyć adres URL wskazówek dojazdu, taki jak poniżej, z zakodowaną nazwą miejsca jako parametrem destination i identyfikatorem miejsca jako parametrem destination_place_id. Tworzenie i używanie adresów URL Map jest bezpłatne, więc nie musisz podawać klucza interfejsu API w adresie URL.
https://www.google.com/maps/dir/?api=1&destination=Google%20London&destination_place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU
Możesz opcjonalnie podać parametr zapytania origin, używając tego samego formatu adresu co w przypadku miejsca docelowego. Jeśli go pominiesz, wskazówki dojazdu będą zaczynać się od bieżącej lokalizacji użytkownika, która może być inna niż miejsce, w którym korzystał z aplikacji do lokalizowania produktów.
Adresy URL Map udostępniają dodatkowe opcje parametrów zapytania, takie jak travelmode i dir_action=navigate, które umożliwiają uruchamianie wskazówek dojazdu z włączoną nawigacją.
Ten klikalny link, który rozszerza poprzedni przykładowy adres URL, ustawia origin jako stadion piłkarski w Londynie i używa travelmode=transit, aby podać wskazówki dojazdu transportem publicznym do miejsca docelowego.
Aby wysłać SMS-a lub e-maila z tym adresem URL, zalecamy obecnie użycie aplikacji innej firmy, np. Twilio. Jeśli używasz App Engine, możesz korzystać z usług innych firm do wysyłania SMS-ów lub e-maili. Więcej informacji znajdziesz w artykule Wysyłanie wiadomości za pomocą usług innych firm.
Wyświetlanie lokalizacji na interaktywnej mapie
Korzystanie z map dynamicznych
| Ten przykład korzysta z: Maps JavaScript API | Dostępne też na: Android | iOS |
Lokalizator jest ważnym elementem wpływającym na wrażenia użytkownika. Niektóre witryny nie mają jednak nawet prostej mapy, co wymaga od użytkowników opuszczenia witryny lub aplikacji w celu znalezienia lokalizacji w pobliżu. Oznacza to, że użytkownicy, którzy muszą przechodzić między stronami, aby uzyskać potrzebne informacje, nie mają zapewnionej optymalnej obsługi. Zamiast tego możesz ulepszyć te wrażenia, umieszczając i dostosowując mapy niestandardowe w swoich aplikacjach.
Dodanie do strony mapy dynamicznej, czyli mapy, którą użytkownicy mogą przesuwać, powiększać i pomniejszać oraz na której mogą uzyskiwać szczegółowe informacje o różnych lokalizacjach i miejscach, wymaga tylko kilku wierszy kodu.
Najpierw musisz dołączyć do strony interfejs Maps JavaScript API.
W tym celu dodaj link do tego skryptu na stronie HTML, w tym libraries=marker, aby móc dodawać do mapy zaawansowane znaczniki.
<script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=marker&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a"></script>Adres URL odwołuje się do funkcji JavaScriptu initMap, która jest uruchamiana po wczytaniu strony. W adresie URL możesz też określić język lub region mapy, aby mieć pewność, że jest ona sformatowana w odpowiedni sposób dla konkretnego kraju, na który kierujesz reklamy. Ustawienie regionu zapewnia też, że zachowanie aplikacji używanych poza Stanami Zjednoczonymi jest dostosowane do ustawionego regionu. Pełną listę obsługiwanych języków i regionów znajdziesz w szczegółach dotyczących zasięgu Google Maps Platform. Dowiedz się też więcej o używaniu parametru region.
Następnie potrzebujesz elementu HTML div, aby umieścić mapę na stronie.
To jest miejsce, w którym będzie wyświetlana mapa.
<div id="map"></div>Następnym krokiem jest skonfigurowanie podstawowych funkcji mapy. Odbywa się to w funkcji skryptu initMap określonej w adresie URL skryptu. W tym skrypcie, który pokazujemy w przykładzie poniżej, możesz ustawić początkową lokalizację, identyfikator mapy (wymagany w przypadku znaczników zaawansowanych i definiowania stylów map w Google Cloud), typ mapy oraz elementy sterujące dostępne dla użytkowników na mapie. Zwróć uwagę, że getElementById() odwołuje się do poprzedniego identyfikatora div „map”.
function initMap() { const map = new google.maps.Map(document.getElementById("map"), { zoom: 12, center: { lat: 51.485925, lng: -0.129500 }, mapId: "DEMO_MAP_ID", zoomControl: false }); }
W przypadku lokalizatora zwykle ustawia się początkową lokalizację, punkt środkowy lub granice oraz poziom powiększenia (jak bardzo mapa jest powiększona w tej lokalizacji). Większość innych elementów, takich jak dostrajanie elementów sterujących, jest opcjonalna, ponieważ to Ty określasz poziom interakcji z mapą.
Dostosowywanie mapy
Wygląd i szczegóły mapy możesz zmieniać na wiele sposobów. Możesz na przykład:
- Twórz własne znaczniki niestandardowe, aby zastąpić domyślne pinezki na mapie.
- Zmień kolory elementów mapy, aby odzwierciedlały Twoją markę.
- Możesz kontrolować, które ciekawe miejsca (atrakcje, restauracje, hotele itp.) i w jakim zagęszczeniu mają być wyświetlane. Pozwala to skupić uwagę użytkowników na Twoich lokalizacjach, a jednocześnie wyróżnić punkty orientacyjne, które pomogą im dotrzeć do najbliższej lokalizacji.
Tworzenie niestandardowych znaczników mapy
Możesz dostosować zaawansowane znaczniki, zmieniając domyślne tło pinezki, obramowanie lub kolor glifu (np. aby wskazać, czy lokalizacja jest obecnie otwarta), zastępując znacznik niestandardową grafiką, np. logo Twojej marki, lub tworząc niestandardowe znaczniki HTML i CSS. Okna informacyjne lub wyskakujące okienka mogą dostarczać użytkownikom dodatkowych informacji, takich jak godziny otwarcia, numer telefonu czy zdjęcia.
Poniżej znajduje się przykładowa mapa, która używa niestandardowych znaczników graficznych. (Kod źródłowy znajdziesz w temacie dotyczącym niestandardowych znaczników graficznych w Maps JavaScript API).
Szczegółowe informacje znajdziesz w dokumentacji dotyczącej zaawansowanych znaczników na platformach JavaScript (internet), Android i iOS.
Nadaj styl mapie
Google Maps Platform umożliwia stylizowanie mapy w sposób, który pomaga użytkownikom znaleźć najbliższą lokalizację i dotrzeć do niej jak najszybciej, a Tobie – wzmocnić markę. Możesz na przykład zmienić kolory mapy, aby pasowały do Twojej marki, i ograniczyć elementy rozpraszające uwagę na mapie, kontrolując miejsca, które są widoczne dla użytkowników. Google Maps Platform udostępnia też szereg szablonów startowych map, z których niektóre są zoptymalizowane pod kątem różnych branż, takich jak turystyka, logistyka, nieruchomości i handel detaliczny.
Style map możesz tworzyć i modyfikować w konsoli Google Cloud na stronie Style map w projekcie.
Rozwiń, aby zobaczyć animacje przedstawiające tworzenie i stylizowanie stylu mapy w konsoli Cloud:
Style mapy branżowej
Animacja pokazująca wstępnie zdefiniowane style map dla konkretnych branż, których możesz używać. Te style stanowią optymalny punkt wyjścia dla każdego typu branży. Na przykład styl mapy „Handel detaliczny” ogranicza liczbę ciekawych miejsc na mapie, dzięki czemu użytkownicy mogą skupić się na Twoich lokalizacjach i punktach orientacyjnych, które pomogą im jak najszybciej i najłatwiej dotrzeć do najbliższej lokalizacji.
Kontrola ciekawych miejsc
Ta animacja ustawia kolor znacznika ciekawych miejsc i zwiększa ich zagęszczenie w stylu mapy. Im większa gęstość, tym więcej znaczników ciekawych miejsc pojawia się na mapie.
Każdy styl mapy ma własny identyfikator. Po opublikowaniu stylu w konsoli Cloud odwołujesz się do tego identyfikatora mapy w kodzie, co oznacza, że możesz aktualizować styl mapy w czasie rzeczywistym bez konieczności refaktoryzacji aplikacji. Nowy wygląd automatycznie pojawi się w istniejącej aplikacji i będzie używany na różnych platformach. Poniższe przykłady pokazują, jak dodać identyfikator mapy do strony internetowej za pomocą interfejsu Maps JavaScript API.
Jeśli w adresie URL skryptu uwzględnisz co najmniej 1 parametr map_ids, interfejs Maps JavaScript API automatycznie udostępni te style, aby przyspieszyć renderowanie mapy, gdy wywołasz je w kodzie.
<script
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&map_ids=MAP_IDs&callback=initMap&solution_channel=GMP_guides_productlocator_v1_a">
</script>Poniższy kod wyświetla na stronie internetowej mapę z własnym stylem. (Nie pokazano elementu HTML <div id="map"></div>, w którym mapa pojawi się na stronie).
map = new google.maps.Map(document.getElementById('map'), { center: {lat: 51.485925, lng: -0.129500}, zoom: 12, mapId: '1234abcd5678efgh' });
Dowiedz się więcej o definiowaniu stylów map w Google Cloud w JavaScript (sieć), Android i iOS.
Łączenie niestandardowych danych o lokalizacji z informacjami o miejscu
W poprzedniej sekcji Wyświetlanie lokalizacji na interaktywnej mapie opisaliśmy, jak za pomocą informacji o miejscu przekazywać użytkownikom szczegółowe informacje o lokalizacjach, takie jak godziny otwarcia, zdjęcia i opinie.
Warto zapoznać się z cenami i poziomami SKU różnych pól danych w Places API (New). Aby zarządzać kosztami, możesz połączyć informacje, które już masz o swoich lokalizacjach, z aktualnymi informacjami z Map Google, takimi jak tymczasowe zamknięcie, godziny otwarcia w święta oraz oceny, zdjęcia i opinie użytkowników. Jeśli masz już informacje kontaktowe swoich sklepów, nie musisz prosić o te pola w informacjach o miejscu i możesz ograniczyć maskę pola, aby pobierać tylko te pola, które chcesz wyświetlać.
Możesz mieć własne dane o miejscach, które uzupełnią informacje o miejscu lub zostaną użyte zamiast nich. Ćwiczenie dotyczące lokalizatora full-stack zawiera przykład użycia GeoJSON z bazą danych do przechowywania i pobierania własnych informacji o lokalizacji.