Product Locator - guida all'implementazione

Panoramica

web iOS API

Google Maps Platform è disponibile per il web (JS, TS), Android e iOS e offre anche API di servizi web per ottenere informazioni su luoghi, indicazioni stradali e distanze. Gli esempi in questa guida sono scritti per una piattaforma, ma vengono forniti link alla documentazione per l'implementazione su altre piattaforme.

Quando gli utenti vedono i tuoi prodotti online, vogliono trovare il modo migliore e più conveniente per ricevere l'ordine. La guida all'implementazione del localizzatore di prodotti e i suggerimenti per la personalizzazione sono ciò che Google consiglia come combinazione ottimale di API di Google Maps Platform per creare esperienze utente di localizzazione dei prodotti eccellenti.

Seguendo questa guida all'implementazione, puoi aiutare i clienti a visualizzare le informazioni dettagliate di cui hanno bisogno per trovare i tuoi prodotti e fornire loro indicazioni stradali per raggiungere il negozio che vende l'articolo che cercano, sia che si spostino in auto, in bicicletta, a piedi o con i mezzi pubblici.

Architettura di sistema del localizzatore di prodotti che collega browser web, server web, database di inventario e API di Google Maps Platform
Diagramma dell'architettura (fai clic per ingrandire)

Abilita API

Per implementare Product Locator, devi abilitare le seguenti API nella console Google Cloud. I seguenti link ipertestuali ti indirizzano alla console Google Cloud per abilitare ogni API per il progetto selezionato:

Per saperne di più sulla configurazione, consulta Inizia a utilizzare Google Maps Platform.

Sezioni della guida all'implementazione

Di seguito sono riportate le implementazioni e le personalizzazioni trattate:

  • L'icona del segno di spunta è un passaggio fondamentale dell'implementazione.
  • L'icona a forma di stella è una personalizzazione facoltativa, ma consigliata, per migliorare la soluzione.
Associa le sedi dei negozi ai luoghi di Google Maps Platform Abbina la posizione di un negozio a un luogo in Google Maps Platform.
Identifica la località dell'utente Aggiungi la funzionalità di digitazione per migliorare l'esperienza utente su tutte le piattaforme e l'accuratezza degli indirizzi con il minimo numero di tasti premuti.
Identifica i negozi più vicini Calcola la distanza e il tempo di percorrenza per più origini e destinazioni, specificando facoltativamente varie forme di trasporto, come a piedi, in auto, con il trasporto pubblico o in bicicletta.
Visualizza le informazioni sul negozio Mostra informazioni dettagliate sui tuoi negozi, in modo che gli utenti possano raggiungerli più facilmente.
Fornire indicazioni stradali per la navigazione Ottieni i dati delle indicazioni stradali dall'origine alla destinazione utilizzando varie forme di trasporto, come a piedi, in auto, in bicicletta e con il trasporto pubblico.
Invia le indicazioni stradali al dispositivo mobile Oltre a mostrare le indicazioni stradali sulla tua pagina web, puoi anche inviarle allo smartphone di un utente per la navigazione utilizzando Google Maps ovunque si trovi.
Mostra le tue sedi su una mappa interattiva Crea indicatori di mappa personalizzati per far risaltare le tue sedi e personalizza lo stile della mappa in modo che corrisponda ai colori del tuo brand. Mostra (o nascondi) punti d'interesse (PDI) specifici sulla mappa per aiutare gli utenti a orientarsi meglio e controlla la densità dei PDI per evitare che la mappa sia troppo affollata.
Combina i dati sulla posizione personalizzati con Place Details Combina i dettagli della tua posizione personalizzata con Place Details per fornire agli utenti un ricco insieme di dati per prendere decisioni.

Associa le sedi dei negozi ai luoghi di Google Maps Platform

Ottieni gli ID luogo

Questo esempio utilizza: API Places (nuova) Disponibile anche: JavaScript

Scoprirai di avere un database dei tuoi negozi con informazioni di base come il nome della località, l'indirizzo e il numero di telefono e vorrai associarlo a un luogo in Google Maps Platform come un insieme di destinazioni finali in cui gli utenti possono ritirare i prodotti. Per recuperare le informazioni che Google Maps Platform ha su quel luogo, incluse le coordinate geografiche e le informazioni fornite dagli utenti, trova l'ID luogo corrispondente a ciascuno dei negozi nel tuo database. Puoi effettuare una chiamata all' endpoint Ricerca testuale (nuova) nell'API Places (nuova) e richiedere solo il campo places.id nella maschera di campo (che attiva lo SKU Text Search Essentials IDs Only).

Di seguito è riportato un esempio di richiesta dell'ID luogo per l'ufficio di Google a Londra:

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'

Puoi memorizzare questo ID luogo nel tuo database insieme al resto dei dati del negozio e utilizzarlo come un modo efficiente per richiedere informazioni sul negozio. Di seguito sono riportate le istruzioni per utilizzare l'ID luogo per la geocodifica, il recupero dei dettagli del luogo e la richiesta di indicazioni stradali per il luogo.

Geocodifica le tue località

Questo esempio utilizza: API Geocoding Disponibile anche: JavaScript

Se il tuo database di negozi contiene indirizzi, ma non coordinate geografiche, utilizza l'API Geocoding per ottenere la latitudine e la longitudine di quell'indirizzo per calcolare quali negozi sono più vicini al cliente. Puoi geocodificare il negozio lato server, memorizzare le latitudini e le longitudini nel tuo database e aggiornarle almeno ogni 30 giorni.

Ecco un esempio di utilizzo dell'API Geocoding per ottenere la latitudine e la longitudine dell'ID luogo restituito per l'ufficio di Google a Londra:

```html
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU&key=YOUR_API_KEY&solution_channel=GMP_guides_productlocator_v1_a
```

Identificare la località dell'utente

Questo esempio utilizza: Place Autocomplete nell'API Maps JavaScript Disponibile anche per: Android | iOS

Un componente chiave di Product Locator è l'identificazione della posizione di partenza dell'utente. Puoi offrire all'utente due opzioni per specificare la posizione di partenza: digitare l'origine della ricerca o concedere le autorizzazioni per la geolocalizzazione del browser web o per i servizi di geolocalizzazione mobile.

Gestisci le voci digitate utilizzando il completamento automatico

Gli utenti di oggi sono abituati alla funzionalità di completamento automatico della versione consumer di Google Maps. Questa funzionalità può essere integrata in qualsiasi applicazione utilizzando le librerie Places di Google Maps Platform su dispositivi mobili e sul web. Quando un utente digita un indirizzo, il completamento automatico compila il resto tramite l'utilizzo di widget. Puoi anche fornire la tua funzionalità di completamento automatico utilizzando direttamente l'API di dati Place Autocomplete.

Campo di immissione della ricerca che mostra i suggerimenti di completamento automatico dell'indirizzo man mano che l'utente digita
Funzionalità di completamento automatico degli indirizzi (fai clic per ingrandire)

Nell'esempio seguente, aggiungi le librerie Places e Marker al tuo sito aggiungendo il parametro libraries=places,marker all'URL dello script dell'API Maps JavaScript.

<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>

Successivamente, aggiungi un elemento contenitore alla pagina in cui verrà aggiunto il widget PlaceAutocompleteElement:

<div id="autocomplete-container"></div>

Infine, inizializza il widget PlaceAutocompleteElement e aggiungilo al container. Se limiti le previsioni di completamento automatico di Place Autocomplete con includedPrimaryTypes: ["geocode"], il widget viene configurato in modo da accettare indirizzi, quartieri, città e codici postali, così gli utenti possono inserire qualsiasi livello di specificità per descrivere la loro origine. Quando un utente seleziona una previsione, viene attivato l'evento gmp-select e puoi chiamare place.fetchFields() per richiedere il campo location contenente la latitudine e la longitudine dell'origine dell'utente. Utilizzerai queste coordinate della mappa per indicare la relazione delle tue sedi con l'origine.

// 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);
});
}

In questo esempio, una volta che l'utente seleziona l'indirizzo, viene avviata la funzione searchFromOrigin(). In questo modo, viene presa la posizione del risultato corrispondente, ovvero la posizione dell'utente, e vengono cercate le posizioni più vicine utilizzando queste coordinate come origine, come descritto nella sezione Identifica i negozi più vicini.

Visualizzazione dei dettagli del prodotto che mostra le sedi dei negozi vicini con disponibilità dello stock e distanza
Mostra le opzioni di località (fai clic per ingrandire)

Espandi questa sezione per visualizzare le procedure dettagliate video per l'aggiunta di Place Autocomplete alla tua app:

Sito web

App Android

App per iOS

Utilizza la geolocalizzazione del browser

Per richiedere e gestire la geolocalizzazione del browser HTML5, scopri come attivare una finestra Usa la mia posizione:

Autorizzazione del browser per la posizione dell'utente
Richiesta di autorizzazione del browser web (fai clic per ingrandire)

Identifica i negozi più vicini

Questo esempio utilizza: Libreria Routes, API Maps JavaScript Disponibile anche: API Routes

Una volta ottenuta la posizione dell'utente, puoi confrontarla con quella dei tuoi negozi. Se esegui questa operazione con la classe RouteMatrix nella libreria Routes, API Maps JavaScript (o la funzionalità Compute Route Matrix nell'API Routes), aiuti gli utenti a selezionare la località più comoda per loro in base al tempo di percorrenza o alla distanza stradale.

Il modo standard di organizzare un elenco di località è ordinarle in base alla distanza. Spesso questa distanza viene calcolata semplicemente utilizzando la linea retta da un utente alla località, ma questo può essere fuorviante. La linea retta potrebbe attraversare un fiume invalicabile o strade trafficate in un momento in cui un'altra posizione potrebbe essere più comoda. Questo è importante quando hai più sedi a pochi chilometri di distanza l'una dall'altra.

Il metodo RouteMatrix.computeRouteMatrix funziona prendendo un elenco di località di partenza e di destinazione e restituendo non solo la distanza, ma anche il tempo di percorrenza tra queste località. Nel caso di un utente, l'origine sarebbe la sua posizione attuale o il punto di partenza desiderato, mentre le destinazioni sarebbero quelle delle località. Le origini e le destinazioni possono essere specificate come coppie di coordinate, ID luogo o indirizzi. Puoi utilizzare RouteMatrix.computeRouteMatrix con preferenze di routing come TRAFFIC_AWARE per mostrare i risultati in base ai tempi di guida attuali o futuri.

L'esempio seguente chiama RouteMatrix.computeRouteMatrix nella libreria Routes, API Maps JavaScript, specificando l'origine dell'utente e fino a 25 sedi di negozi alla volta.

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;
    });
}

Per ogni località nelle vicinanze puoi visualizzare lo stato dello stock del prodotto in base al tuo database dell'inventario.

Visualizza le informazioni sul negozio

Questo esempio utilizza: Libreria Places, API Maps JavaScript Disponibili anche: Places SDK for Android | Places SDK for iOS | API Places (novità)

Puoi condividere dettagli completi sui luoghi, come dati di contatto, orari di apertura e stato di apertura attuale, per aiutare i clienti a scegliere la sede preferita o a finalizzare l'ordine.

Dopo aver effettuato una chiamata all'API Maps JavaScript per ottenere i dettagli dei luoghi, puoi filtrare ed eseguire il rendering della risposta.

Opzioni dei negozi vicini che mostrano lo stato dello stock dei prodotti, l'orario di apertura e la distanza di viaggio
Mostra le opzioni del negozio (fai clic per ingrandire)

Per richiedere i dettagli dei luoghi, devi avere l'ID luogo di ciascuna delle tue sedi. Consulta Ottieni gli ID luogo per recuperare l'ID luogo della tua posizione.

La seguente richiesta Place Details utilizza la classe Place per restituire il nome, le coordinate, il sito web, il numero di telefono, la valutazione e gli orari per l'ID luogo di Google London:

const place = new google.maps.places.Place({
  id: 'ChIJVSZzVR8FdkgRTyQkxxLQmVU',
});

await place.fetchFields({ fields: [ 'displayName', 'nationalPhoneNumber', 'location', 'regularOpeningHours', 'rating', 'utcOffsetMinutes', 'websiteURI', ], });

createMarker(place);


Migliora il localizzatore di prodotti

A seconda delle esigenze della tua attività o degli utenti, puoi migliorare ulteriormente l'esperienza utente.

Fornire indicazioni stradali per la navigazione

Questo esempio utilizza: Libreria Routes, API Maps JavaScript Disponibile anche: servizio web API Routes da utilizzare su Android e iOS, direttamente dall'applicazione o da remoto tramite un proxy server

Quando mostri agli utenti le indicazioni stradali all'interno del tuo sito o delle tue applicazioni, questi non devono uscire dal tuo sito e distrarsi con altre pagine o vedere i concorrenti sulla mappa. Con l'API Routes, puoi anche richiedere percorsi ecosostenibili per stimare il consumo di carburante o energia e mostrare l'impatto ambientale di un viaggio.

La classe Route nella libreria Routes, API Maps JavaScript, include anche metodi come createPolylines() e createWaypointAdvancedMarkers() che ti consentono di elaborare i risultati e visualizzarli su una mappa.

Di seguito è riportato un esempio di richiesta e visualizzazione di un percorso su una mappa. Per saperne di più sull'esempio, consulta Ottieni un percorso.

Invia le indicazioni stradali al dispositivo mobile

Per consentire agli utenti di raggiungere ancora più facilmente una località, puoi inviare loro un link con le indicazioni stradali via email o SMS. Quando l'utente fa clic sul link, l'app Google Maps si avvia sul suo smartphone, se installata, oppure viene caricato maps.google.com nel browser web del dispositivo. Entrambe queste esperienze offrono all'utente la possibilità di utilizzare la navigazione passo passo, inclusa la guida vocale, per raggiungere la destinazione.

Utilizza gli URL di Maps per comporre un URL delle indicazioni stradali come il seguente, con il nome del luogo codificato come URL come parametro destination e l'ID luogo come parametro destination_place_id. La creazione o l'utilizzo degli URL di Maps non comporta alcun costo, pertanto non è necessario includere una chiave API nell'URL.

https://www.google.com/maps/dir/?api=1&destination=Google%20London&destination_place_id=ChIJVSZzVR8FdkgRTyQkxxLQmVU

Facoltativamente, puoi fornire un parametro di query origin utilizzando lo stesso formato di indirizzo della destinazione. Tuttavia, se lo ometti, le indicazioni stradali iniziano dalla posizione corrente dell'utente, che potrebbe essere diversa da quella in cui stava utilizzando l'app Product Locator. Gli URL di Maps forniscono opzioni aggiuntive per i parametri di query, come travelmode e dir_action=navigate per avviare le indicazioni stradali con la navigazione attiva.

Questo link selezionabile, che estende l'URL di esempio precedente, imposta origin come uno stadio di calcio di Londra e utilizza travelmode=transit per fornire indicazioni per il trasporto pubblico per la destinazione.

Per inviare un SMS o un'email contenente questo URL, al momento ti consigliamo di utilizzare un'applicazione di terze parti come twilio. Se utilizzi App Engine, puoi utilizzare società di terze parti per inviare SMS o email. Per saperne di più, consulta Invio di messaggi con servizi di terze parti.

Mostra le tue sedi su una mappa interattiva

Utilizza le mappe dinamiche

Questo esempio utilizza: API Maps JavaScript Disponibile anche per: Android | iOS

Un localizzatore è una parte importante dell'esperienza utente. Tuttavia, alcuni siti potrebbero non avere nemmeno una mappa semplice, costringendo gli utenti a uscire dal sito o dall'app per trovare una sede nelle vicinanze. Ciò significa un'esperienza non ottimale per gli utenti che devono navigare tra le pagine per ottenere le informazioni di cui hanno bisogno. Puoi invece migliorare questa esperienza incorporando e personalizzando le mappe nelle tue applicazioni.

L'aggiunta di una mappa dinamica alla tua pagina, ovvero una mappa che gli utenti possono spostare, ingrandire e rimpicciolire e di cui possono ottenere dettagli su diverse località e punti di interesse, può essere eseguita con poche righe di codice.

Innanzitutto, devi includere l'API Maps JavaScript nella pagina. Per farlo, collega il seguente script alla tua pagina HTML, incluso libraries=marker, in modo da poter aggiungere indicatori avanzati alla mappa.

<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>

L'URL fa riferimento alla funzione JavaScript initMap che viene eseguita quando la pagina viene caricata. Nell'URL puoi anche definire la lingua o la regione della mappa per assicurarti che sia formattata nel modo corretto per il paese specifico che hai scelto come target. L'impostazione di una regione garantisce inoltre che il comportamento delle app utilizzate al di fuori degli Stati Uniti sia orientato verso la regione impostata. Consulta i dettagli sulla copertura di Google Maps Platform per un elenco completo delle lingue e delle regioni supportate e scopri di più sull'utilizzo del parametro region.

Successivamente, hai bisogno di un elemento HTML div per posizionare la mappa sulla pagina. Questo è il punto in cui verrà visualizzata la mappa.

<div id="map"></div>

Il passaggio successivo consiste nell'impostare la funzionalità di base della mappa. Questa operazione viene eseguita nella funzione di script initMap specificata nell'URL dello script. In questo script, mostrato nell'esempio seguente, puoi impostare la posizione iniziale, un ID mappa (obbligatorio per gli indicatori avanzati e la personalizzazione delle mappe basata su cloud), il tipo di mappa e i controlli disponibili sulla mappa per gli utenti. Tieni presente che getElementById() fa riferimento all'ID div della "mappa" precedente.

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
});
}

Per un localizzatore, in genere è importante impostare la posizione iniziale, il punto centrale o i limiti e il livello di zoom (quanto la mappa è ingrandita su quella posizione). La maggior parte degli altri elementi, come la regolazione dei controlli, è facoltativa, in quanto sei tu a determinare il livello di interazione con la mappa.

Personalizza la mappa

Puoi modificare l'aspetto e i dettagli della mappa in diversi modi. Ad esempio, puoi:

  • Crea i tuoi indicatori personalizzati per sostituire i segnaposti predefiniti della mappa.
  • Modifica i colori degli elementi della mappa in modo che riflettano il tuo brand.
  • Controlla quali punti di interesse visualizzare (attrazioni, ristoranti, alloggi e così via) e con quale densità, in modo da concentrare l'attenzione degli utenti sulle tue sedi e, al contempo, evidenziare i punti di riferimento che li aiutano a raggiungere la sede più vicina.

Crea indicatori di mappa personalizzati

Puoi personalizzare gli indicatori avanzati modificando lo sfondo, il bordo o il colore del glifo predefiniti del segnaposto (ad esempio, per indicare se una località è attualmente aperta), sostituendo l'indicatore con un'immagine grafica personalizzata, come il logo del tuo brand, o creando indicatori HTML e CSS personalizzati. Le finestre informative o popup possono fornire informazioni aggiuntive agli utenti, come orari di apertura, numero di telefono o foto.

Di seguito è riportata una mappa di esempio che utilizza indicatori grafici personalizzati. (Consulta il codice sorgente nell' argomento relativo agli indicatori grafici personalizzati dell'API Maps JavaScript.)

Per informazioni dettagliate, consulta la documentazione relativa ai segnaposto avanzati per JavaScript (web), Android e iOS.

Definizione dello stile della mappa

Google Maps Platform ti consente di personalizzare lo stile della mappa in modo da aiutare gli utenti a trovare la sede più vicina, raggiungerla il più rapidamente possibile e rafforzare il tuo brand. Ad esempio, puoi modificare i colori della mappa in modo che corrispondano al tuo branding e ridurre le distrazioni sulla mappa controllando i punti di interesse visibili agli utenti. Google Maps Platform fornisce anche una serie di modelli di mappe di base, alcuni dei quali sono ottimizzati per diversi settori, come viaggi, logistica, immobiliare e vendita al dettaglio.

Puoi creare o modificare gli stili di mappa nella pagina Stili di mappa della console Google Cloud nel tuo progetto.

Espandi per visualizzare le animazioni della creazione e della personalizzazione degli stili di mappa nella console Cloud:

Stili di mappa per il settore

Questa animazione mostra gli stili di mappa predefiniti specifici del settore che puoi utilizzare. Questi stili forniscono un punto di partenza ottimale per ogni tipo di settore. Ad esempio, lo stile di mappa Retail riduce i punti d'interesse sulla mappa, consentendo agli utenti di concentrarsi sulle tue sedi, nonché sui punti di riferimento per aiutarli a raggiungere la sede più vicina nel modo più rapido e sicuro possibile.

Nella pagina Stile di mappa, il mouse fa clic su Crea nuovo stile di mappa. Nella pagina Nuovo stile di mappa, il mouse fa clic sul pulsante di opzione accanto a ciascuno dei seguenti stili ottimizzati per il settore: Viaggi, Logistica, Immobiliare e Retail. Quando fai clic su ogni pulsante, la descrizione dello stile di mappa e l'anteprima grafica cambiano.

Controllo dei punti d'interesse

Questa animazione imposta il colore dell'indicatore per i punti di interesse e aumenta la densità dei PDI nello stile di mappa. Maggiore è la densità, più indicatori dei PDI vengono visualizzati sulla mappa.

Nella pagina Stile di mappa, il mouse fa clic su Crea nuovo stile di mappa. Nella pagina Nuovo stile di mappa, in Crea il tuo stile, il pulsante di opzione Google Maps è selezionato. Il mouse fa clic sul pulsante di opzione Atlas per lo stile Atlas,
              poi su Apri nell'editor di stili. Nell'editor di stili, il mouse fa clic sulla funzionalità Punti di interesse, poi sull'elemento Icona, impostando il colore su rosso. Il mouse seleziona la casella di controllo Densità PDI e fa scorrere il controllo della densità verso destra per ottenere la densità massima. Man mano che la densità aumenta, nell'anteprima della mappa vengono visualizzati sempre più indicatori rossi. Il mouse si sposta sul pulsante Salva.

Ogni stile di mappa ha il proprio ID. Dopo aver pubblicato uno stile nella console Cloud, fai riferimento all'ID mappa nel codice, il che significa che puoi aggiornare uno stile di mappa in tempo reale senza rifattorizzare l'app. Il nuovo aspetto verrà visualizzato automaticamente nell'applicazione esistente e verrà utilizzato su tutte le piattaforme. I seguenti esempi mostrano come aggiungere un ID mappa a una pagina web utilizzando l'API Maps JavaScript.

Se includi uno o più map_ids nell'URL dello script, l'API Maps JavaScript rende automaticamente disponibili questi stili per un rendering più rapido della mappa quando li richiami nel codice.

<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>

Il seguente codice mostra una mappa con stile nella pagina web. (Non è mostrato un elemento HTML <div id="map"></div> in cui la mappa verrà visualizzata sulla pagina.)

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: 51.485925, lng: -0.129500},
zoom: 12,
mapId: '1234abcd5678efgh'
});

Scopri di più sull'integrazione della Personalizzazione delle mappe basata su cloud in JavaScript (web), Android e iOS.

Combina i dati sulla posizione personalizzati con Place Details

La sezione precedente Mostra le tue sedi su una mappa interattiva descrive l'utilizzo di Place Details per fornire agli utenti un livello di informazioni dettagliato sulle tue sedi, ad esempio orari di apertura, foto e recensioni.

È utile comprendere i livelli di prezzi e SKU dei diversi campi di dati nell'API Places (New). Per gestire i costi, una strategia consiste nel combinare le informazioni che già hai sulle tue sedi con quelle aggiornate di Google Maps, come chiusura temporanea, orari di apertura durante le festività, valutazioni degli utenti, foto e recensioni. Se hai già i dati di contatto dei tuoi negozi, non dovrai richiedere questi campi da Place Details e potrai limitare la maschera di campo in modo da recuperare solo i campi che vuoi visualizzare.

Potresti avere i tuoi dati sui luoghi da integrare o utilizzare al posto di Place Details. Il codelab per il localizzatore full-stack fornisce un esempio di utilizzo di GeoJSON con un database per archiviare e recuperare i dettagli della tua posizione.