Criteri dell'API Map Tiles

Questo documento elenca i requisiti per le applicazioni sviluppate con l'API Map Tiles. Tieni presente che l'utilizzo dell'API Map Tiles è regolato dal Contratto stipulato con Google.

Fornire termini e condizioni d'uso e norme sulla privacy

Se sviluppi un'applicazione API Map Tiles, devi rendere disponibili i Termini e condizioni d'uso e le Norme sulla privacy con la tua applicazione, che sia conforme alle linee guida delineate nel tuo Contratto con Google:

  • I Termini e condizioni d'uso e le Norme sulla privacy devono essere disponibili pubblicamente.
  • Devi specificare esplicitamente nei Termini e condizioni d'uso della tua applicazione che gli utenti sono vincolati dai Termini di servizio di Google quando utilizzi l'applicazione.
  • Devi comunicare agli utenti nelle Norme sulla privacy che utilizzi le API di Google Maps e includere, per riferimento, le Norme sulla privacy di Google.

La posizione consigliata in cui rendere disponibili i Termini e condizioni d'uso e le Norme sulla privacy dipende dalla piattaforma dell'applicazione.

App mobile

Se sviluppi un'app mobile, è consigliabile fornire un link ai Termini e condizioni d'uso e alle Norme sulla privacy nella pagina di download dell'applicazione nello store pertinente e in un menu di impostazioni dell'applicazione.

Applicazioni web

Se sviluppi un'applicazione web, ti consigliamo di fornire un link ai Termini e condizioni d'uso e alle Norme sulla privacy nel piè di pagina del tuo sito web.

Precaricamento, memorizzazione nella cache o archiviazione di contenuti

Le applicazioni che utilizzano l'API Map Tiles sono soggette ai termini del Contratto con Google. In base ai termini del Contratto, l'utente non deve precaricare, indicizzare, archiviare o memorizzare nella cache alcun Contenuto, fatta eccezione per le condizioni limitate indicate nei termini.

In particolare, le applicazioni dovrebbero utilizzare l'API Map Tiles per le visualizzazioni delle mappe. Non puoi utilizzare l'API Map Tiles per casi d'uso che non riguardano la visualizzazione, ad esempio:

  • Analisi delle immagini
  • Interpretazione automatica
  • Rilevamento/identificazione degli oggetti
  • Estrazione o rivendita di dati geografici
  • Utilizzi offline, incluso per quanto segue

Le risposte dell'API Map Tiles possono includere intestazioni Cache-Control che devono essere implementate in base alla documentazione sul protocollo HTTP. Ad esempio, il tuo client deve rispettare il valore max-age, il valore stale-while-revalidate, l'istruzione must-revalidate e l'istruzione private quando vengono trasmessi nella risposta.

Le risposte dell'API Map Tiles possono includere anche un'intestazione ETag, che deve essere implementata in base alla documentazione relativa al protocollo HTTP in caso di richiesta di riconvalida.

Visualizzazione dei risultati dell'API Map Tiles

Puoi visualizzare i risultati dell'API Map Tiles su una mappa di Google Maps o senza una mappa. Se vuoi visualizzare i risultati dell'API Map Tiles su una mappa, questi risultati devono essere visualizzati su una mappa di Google Maps. È vietato utilizzare i dati dell'API Map Tiles su una mappa diversa da una mappa di Google.

Quando utilizzi l'API Map Tiles per visualizzare Google Maps, devi anche mostrare il logo di Google sulla mappa, senza modificarlo in alcun modo. Devi posizionare il logo di Google nell'angolo in basso a sinistra della mappa e le informazioni di attribuzione nell'angolo a destra della mappa. Per ulteriori informazioni, consulta le nostre linee guida per il Brand Resource Center.

Nel caso di esperienze con le mappe 3D più cinematografiche, ovvero se i tuoi requisiti di progettazione dell'esperienza utente non sono facilmente in grado di soddisfare queste linee guida per il posizionamento, devi comunque mostrare chiaramente il logo Google all'inizio, alla fine o a entrambe le estremità dell'esperienza, in modo che il pubblico comprenda la paternità della mappa. Devi comunque rispettare la visualizzazione delle attribuzioni di dati di terze parti come descritto di seguito per tutta la durata dell'esperienza cinematografica. Per ulteriori indicazioni, consulta Visualizzazione delle attribuzioni di loghi e dati in visualizzazioni ibride di seguito.

Il seguente esempio di mappa mostra il logo di Google in basso a sinistra nella mappa e l'attribuzione in basso a destra.

Il seguente file ZIP contiene il logo di Google nelle dimensioni corrette per applicazioni desktop, Android e iOS. Non puoi ridimensionare o modificare in alcun modo questi loghi.

Scarica: google_logo.zip

Non modificare l'attribuzione. Non rimuovere, oscurare o escludere le informazioni sull'attribuzione. Non puoi utilizzare i loghi di Google incorporati (ad esempio, "Queste mappe provengono da [Google_logo]").

Anticipa l'attribuzione. Se utilizzi screenshot di immagini di Google al di fuori degli incorporamenti diretti, includi l'attribuzione standard così come appare nell'immagine. Se necessario, puoi personalizzare lo stile e il posizionamento del testo di attribuzione, a condizione che il testo si trovi nelle vicinanze dei contenuti e sia leggibile per lo spettatore o il lettore medio. Non puoi rimuovere l'attribuzione dai contenuti, ad esempio alla fine del libro, nei riconoscimenti dei tuoi file o del tuo programma oppure nel piè di pagina del tuo sito web.

Includi fornitori di dati di terze parti. Alcuni dati e immagini presenti nei nostri prodotti di mappatura provengono da fornitori diversi da Google. Se utilizzi tali immagini, il testo dell'attribuzione deve riportare il nome "Google" e i fornitori di dati pertinenti, ad esempio "Dati mappa: Google, Maxar Technologies". Se esistono fornitori di dati di terze parti menzionati nelle immagini, includere solo "Google" o il logo di Google non rappresenta un'attribuzione corretta.

Se utilizzi Google Maps Platform su un dispositivo in cui la visualizzazione dell'attribuzione non è pratica, contatta il team di vendita di Google per discutere delle licenze appropriate per il tuo caso d'uso.

Visualizzazione del logo Google con renderer di terze parti

Quando utilizzi l'API Map Tiles per visualizzare Google Maps utilizzando un renderer di terze parti, non puoi sovrapporre o oscurare il logo Google con altri loghi, ad esempio quello del renderer. Mantieni una distanza ragionevole tra il logo di Google e quello di terze parti in modo che vengano visualizzati come loghi indipendenti. Nessun logo può sovrapporsi o oscurare l'attribuzione dei dati fornita dalla risposta dell'API.

Immagine sottoposta a rendering che mostra i loghi di Google e Cesium

Visualizzazione delle attribuzioni dei dati di Google

I dati restituiti dall'API Map Tiles richiedono la visualizzazione delle informazioni sull'attribuzione e sul copyright provenienti dalle richieste di informazioni dell'area visibile o dei metadati appropriati. Dovresti visualizzare queste informazioni per intero come indicato nella posizione appropriata, in genere nell'angolo in basso a destra della serie di riquadri visualizzati o nella visualizzazione del renderer 3D. Tieni presente che le stringhe di attribuzione sono variabili, a seconda dei dati della mappa richiesti dall'area visibile del renderer.

Se non è possibile visualizzare le attribuzioni dei dati per intero a causa di vincoli relativi alle dimensioni dell'area visibile, ti consigliamo di aggiungere un elemento UI cliccabile o al passaggio del mouse denominato "Origini dati", che si apre all'interno della finestra della mappa per fornire informazioni sull'attribuzione. Punta sempre a mantenere buone pratiche cartografiche.

Piè di pagina contenente il logo di Google e l'attribuzione del fornitore di dati.

Visualizzazione delle attribuzioni di dati di terze parti

Quando utilizzi l'API Map Tiles per visualizzare i dati di Google Maps come mappa di base e sovrapporre dati geospaziali di terze parti (non Google), potrebbe esserti richiesto di mostrare l'attribuzione del fornitore di dati di terze parti. Non devi sovrapporre o oscurare in nessun modo l'attribuzione dei dati di Google con l'attribuzione dei dati di terze parti. L'attribuzione di dati di terze parti deve essere chiaramente dissociata dalle attribuzioni dei dati di Google. Inoltre, deve essere chiaro che il logo di Google e l'attribuzione dei dati di Google sono associati alla mappa di base e tra loro.

Mostrare le attribuzioni di loghi e dati in visualizzazioni ibride

Quando utilizzi i dati di Google Maps come mappa di base e sovrapponi i dati della tua mappa, devi assicurarti che il pubblico comprenda appieno quale parte della visualizzazione della mappa è attribuita a Google e quali parti sono attribuite ai tuoi dati mappa. Inoltre, segui le linee guida nella sezione Visualizzazione del logo Google sopra riportata.

Ad esempio, potresti combinare riquadri 3D fotorealistici (come riempitivo dello sfondo) con i tuoi modelli fotorealistici (in primo piano). Gli utenti potrebbero essere confusi riguardo ai componenti della scena che hanno origine dai dati di Google Maps. In questi casi, devi indicare chiaramente nella stringa di attribuzione dell'interfaccia utente o nel flusso utente quale parte della scena ha origine dai dati di Google Maps. È tua responsabilità rispettare eventuali requisiti di attribuzione di terze parti applicabili alle origini dati che utilizzi con i dati di Google Maps.

Overlay di dati geografici con riquadri 3D fotorealistici

Puoi sovrapporre i tuoi oggetti 3D a riquadri 3D fotorealistici, purché questi non siano estratti, tracciati o altrimenti derivati da riquadri 3D fotorealistici a mano o a macchina.

Creazione di video con l'API Map Tiles

  • Video promozionali: puoi creare video promozionali soggetti ai termini del Contratto e a quanto segue:
    • Il video promozionale non deve includere immagini di Street View.
    • Il video promozionale non deve durare più di 30 secondi.
    • Il video promozionale deve riguardare le funzionalità delle applicazioni.
    • Il video promozionale deve essere chiaramente contrassegnato "solo a scopi promozionali" e deve rispettare le Linee guida per l'attribuzione nelle Norme relative all'API Map Tiles.
    • Il video promozionale non può essere rivenduto separatamente o come parte del software, dell'applicazione o dell'esperienza utente.
  • Rimozione: è tua responsabilità soddisfare tutte le richieste di rimozione del video promozionale, incluse quelle provenienti da terze parti.

Ottieni le informazioni sull'attribuzione e sul copyright dal campo copyright nelle risposte delle seguenti chiamate API, a seconda del servizio che stai utilizzando:

Riquadri 2D

Riquadri Roadmap, Satellite e Rilievo

Le informazioni su copyright e attribuzione sono disponibili nella risposta alle informazioni sull'area visibile, come mostrato nell'esempio che segue.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    ...
  ]
}

Riquadri Street View

Le informazioni sul copyright e sull'attribuzione sono disponibili nella risposta ai metadati di Street View. Ad esempio:

{
  "panoId": "Zzl28rqGJgaL2IdkUleP8A",
  "lat": 50.059138596550696,
  "imageHeight": 6656,
  "imageWidth": 13312,
  "tileHeight": 512,
  "tileWidth": 512,
  "copyright": "From the Owner, Photo by: Google",
  …
}

L'ID panoramica, utilizzato per identificare in modo univoco una panoramica Street View, è esente da limitazioni nella memorizzazione nella cache. Pertanto, puoi memorizzare i valori degli ID panoramica a tempo indeterminato. I valori ID panoramica vengono restituiti nel campo panoId nelle risposte dell'API Street View Static.

Riquadri 3D fotorealistici

Per i riquadri 3D fotorealistici, i dati di attribuzione vengono restituiti in ogni richiesta di riquadro. Devi aggregare, ordinare e visualizzare in una riga tutte le attribuzioni per i riquadri visualizzati; di solito nella parte inferiore del rendering. Ad esempio, puoi trovare le attribuzioni dei dati in un riquadro glTF cercando in asset, copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

CesiumJS

Se utilizzi CesiumJS come renderer, per visualizzare le attribuzioni devi attivare showCreditsOnScreen nell'HTML di rendering.

// Add Photorealistic 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
      url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
      // This property is needed to appropriately display attributions
      // as required.
      showCreditsOnScreen: true,
    }));

Cesium for Unreal

Se utilizzi Cesium for Unreal come renderer, per visualizzare le attribuzioni devi attivare il campo Show Credits On Screen (Mostra crediti sullo schermo) in World Outliner.

Come attivare le attribuzioni per Cesium for Unreal

Cesium per Unity

Se utilizzi Cesium for Unity come renderer, per visualizzare le attribuzioni devi attivare il campo Mostra crediti sullo schermo nella console di ispezione.

Come attivare le attribuzioni per Cesium for Unity

Linee guida per lo stile dell'attribuzione Google

Di seguito sono riportate le linee guida di stile per le attribuzioni di Google in CSS e HTML se non riesci a utilizzare il logo di Google scaricabile.

Spazio vuoto

La quantità di spazio vuoto intorno al logo completo deve essere uguale o superiore all'altezza della "G" in Google.

Lo spazio tra il testo dell'attribuzione e il logo di Google deve essere la metà della larghezza della "G".

Leggibilità

La riga dell'autore deve essere sempre chiara, leggibile e avere la giusta variazione di colore per un determinato sfondo. Assicurati sempre di offrire un contrasto sufficiente per la variante del logo selezionata.

Colore

Utilizza il testo Google Material Gray 700 su uno sfondo bianco o chiaro con una percentuale massima di nero compresa tra 0% e 40%.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Su sfondi più scuri, fotografie o con motivi meno occupati, usa un testo bianco per la riga dell'autore e l'attribuzione.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Carattere

Utilizza il carattere Roboto.

CSS di esempio

Il seguente codice CSS, se applicato al testo "Google", visualizzerebbe "Google" con il carattere, il colore e la spaziatura appropriati su uno sfondo bianco o chiaro.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;