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 tuo contratto con Google.

Fornire termini e condizioni d'uso e norme sulla privacy

Se sviluppi un'applicazione API Map Tiles, devi rendere disponibili i Termini di utilizzo e le Norme sulla privacy con la tua applicazione, che devono rispettare le linee guida descritte nel tuo contratto con Google:

  • I Termini e condizioni d'uso e le Norme sulla privacy devono essere disponibili pubblicamente.
  • Devi dichiarare esplicitamente nei Termini e condizioni d'uso della tua applicazione che, utilizzandola, gli utenti sono vincolati ai Termini di servizio di Google.
  • Devi informare gli utenti nelle tue Norme sulla privacy che utilizzi le API di Google Maps e incorporare per riferimento le Norme sulla privacy di Google.

Il luogo consigliato per rendere disponibili i Termini e condizioni d'uso e le Norme sulla privacy dipende dalla piattaforma della tua applicazione.

App per dispositivi mobili

Se stai sviluppando un'app mobile, ti consigliamo di fornire un link ai Termini e condizioni d'uso e alle Norme sulla privacy nella pagina di download dell'applicazione nello store di applicazioni pertinente e in un menu delle impostazioni dell'applicazione.

Applicazioni web

Se stai sviluppando un'applicazione web, ti consigliamo di fornire un link ai Termini di utilizzo e alle Norme sulla privacy a piè di pagina del tuo sito web.

Pre-fetching, memorizzazione nella cache o archiviazione di contenuti

Le applicazioni che utilizzano l'API Map Tiles sono vincolate dai termini del tuo contratto con Google. Fatto salvo quanto stabilito nei termini del Contratto, non devi prelevare, indicizzare, memorizzare o memorizzare nella cache alcun Contenuto, salvo nelle limitate condizioni indicate nei termini.

Nello specifico, le applicazioni devono utilizzare l'API Map Tiles per le visualizzazioni delle mappe. Non puoi utilizzare l'API Map Tiles per casi d'uso non di visualizzazione, ad esempio:

  • Analisi delle immagini
  • Interpretazione automatica
  • Rilevamento o identificazione di oggetti
  • Estrazione o rivendita di dati geografici
  • Utilizzi offline, inclusi quelli per le opzioni sopra indicate

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

Le risposte dell'API Map Tiles possono includere anche un'intestazione ETag che deve essere implementata anche in base alla documentazione del protocollo HTTP quando si effettua la richiesta con la convalida.

Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente da limitazioni alla memorizzazione nella cache. L'ID luogo viene restituito nel campo place_id nelle risposte dell'API Map Tiles. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida sugli ID luogo.

Quando utilizzi l'API Map Tiles per visualizzare Google Maps, devi anche visualizzare il logo di Google sulla mappa e non devi modificarlo in alcun modo. Devi posizionare il logo Google nell'angolo in basso a sinistra della mappa e le informazioni sull'attribuzione nell'angolo a destra della mappa. Per saperne di più, consulta le nostre linee guida del Centro risorse per i brand.

Per le esperienze con mappe 3D più cinematografiche, ovvero se i requisiti di progettazione dell'esperienza utente non possono facilmente adattarsi a queste linee guida di posizionamento, devi comunque mostrare chiaramente il logo di Google all'inizio o alla fine o a entrambe le estremità dell'esperienza, in modo che la paternità della mappa sia compresa dal pubblico. Devi comunque rispettare l'obbligo di mostrare le attribuzioni dei dati di terze parti come descritto di seguito per tutta la durata dell'esperienza cinematografica. Per ulteriori indicazioni, consulta la sezione Visualizzazione di loghi e attribuzioni dei dati nelle visualizzazioni ibride di seguito.

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

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

Scarica: google_logo.zip

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

Mantieni l'attribuzione vicina. Se utilizzi screenshot delle immagini di Google al di fuori degli annunci incorporati diretti, includi l'attribuzione standard così come appare nell'immagine. Se necessario, puoi personalizzare lo stile e il posizionamento del testo dell'attribuzione, a condizione che il testo sia nelle immediate vicinanze dei contenuti e leggibile per lo spettatore o il lettore medio. Non puoi spostare l'attribuzione dai contenuti, ad esempio alla fine del libro, ai riconoscimenti dei tuoi file o del tuo programma o al piè di pagina del tuo sito web.

Includi fornitori di dati di terze parti. Alcuni dati e immagini dei nostri prodotti di mappatura provengono da fornitori diversi da Google. Se utilizzi queste immagini, il testo dell'attribuzione deve riportare il nome "Google" e i fornitori di dati pertinenti, ad esempio "Dati mappe: Google, Maxar Technologies". Se nelle immagini sono citati fornitori di dati di terze parti, l'inclusione solo di "Google" o del logo di Google non è un'attribuzione corretta.

Se utilizzi Google Maps Platform su un dispositivo su 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 di Google con visualizzatori di terze parti

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

Immagine visualizzata 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 dell'attribuzione e delle informazioni sul copyright dalle richieste di metadati o informazioni sul viewport appropriate. Devi visualizzare queste informazioni per intero nella posizione appropriata, in genere nell'angolo in basso a destra dell'insieme di riquadri visualizzato o nella visualizzazione del visualizzatore 3D. Tieni presente che le stringhe di attribuzione sono variabili, a seconda dei dati della mappa richiesti dall'area visibile del visualizzatore.

Se non è possibile visualizzare per intero le attribuzioni dei dati a causa di vincoli relativi alle dimensioni della visualizzazione, valuta la possibilità di aggiungere un elemento dell'interfaccia utente selezionabile o con il passaggio del mouse denominato "Origini dati", che si apre nella finestra della mappa per fornire informazioni sull'attribuzione. Cerca sempre di mantenere buone pratiche cartografica.

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

Visualizzazione delle attribuzioni dei 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), potresti dover mostrare l'attribuzione del fornitore di dati di terze parti. Non devi sovrapporre o oscurare in alcun modo l'attribuzione dei dati di Google con l'attribuzione dei dati di terze parti. L'attribuzione dei dati di terze parti deve essere distinta in modo chiaro 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.

Visualizzazione di loghi e attribuzioni dei dati nelle visualizzazioni ibride

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

Ad esempio, puoi combinare i riquadri 3D fotorealistici (come riempimento dello sfondo) con i tuoi modelli fotorealistici (in primo piano). Gli utenti potrebbero avere dubbi su quali componenti della scena provengono 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 proviene dai dati di Google Maps. È tua responsabilità rispettare eventuali requisiti di attribuzione di terze parti che potrebbero essere applicati alle origini dati che utilizzi con i dati di Google Maps.

Overlay di dati geografici con i riquadri 3D fotorealistici

Puoi sovrapporre i tuoi oggetti 3D ai riquadri 3D fotorealistici, a condizione che non siano stati estratti, tracciati o altrimenti derivati manualmente o meccanicamente dai riquadri 3D fotorealistici.

Creazione di video con l'API Map Tiles

  • Video promozionali: puoi creare video promozionali rispettando i termini del Contratto e 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 tue applicazioni.
    • Il video promozionale deve essere contrassegnato in modo chiaro come "solo per scopi promozionali" e deve rispettare le linee guida sull'attribuzione riportate nelle Norme dell'API Map Tiles.
    • Il video promozionale non può essere rivenduto separatamente o nell'ambito del software, dell'applicazione o dell'esperienza utente.
  • Rimozione: sei tenuto a ottemperare a tutte le richieste di rimozione del Video promozionale, incluse quelle di terze parti.

Visualizza le informazioni sull'attribuzione e sul copyright dal campo copyright nelle risposte delle seguenti chiamate API, a seconda del servizio in uso:

Riquadri 2D

Riquadri mappa stradale, satellitari e con rilievi

Le informazioni sul copyright e sull'attribuzione sono disponibili nella risposta alle informazioni sul viewport, come mostrato nell'esempio seguente.

{
  "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 dei 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 panorama, utilizzato per identificare in modo univoco un panorama di Street View, è esente dalla limitazione della memorizzazione nella cache. Pertanto, puoi memorizzare i valori ID panorama indefinitamente. I valori ID panorama 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, in genere nella parte inferiore del rendering. Ad esempio, puoi trovare le attribuzioni dei dati in un elemento 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 visualizzatore, per visualizzare le attribuzioni devi attivare showCreditsOnScreen nel rendering HTML.

// 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 per Unreal

Se utilizzi Cesium for Unreal come renderer, per visualizzare le attribuzioni devi attivare il campo Mostra riconoscimenti sullo schermo in World Outliner.

Come attivare le attribuzioni per Cesium per Unreal

Cesium per Unity

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

Come attivare le attribuzioni per Cesium per Unity

Linee guida di stile per l'attribuzione Google

Di seguito sono riportate le linee guida per gli stili per le attribuzioni di Google in CSS e HTML se non puoi utilizzare il logo di Google scaricabile.

Spazio vuoto

La quantità di spazio vuoto attorno al logo completo deve essere uguale o maggiore rispetto all'altezza della "G" di Google.

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

Leggibilità

Il nome dell'autore deve sempre essere chiaro, leggibile e nella variante di colore corretta per un determinato sfondo. Assicurati sempre di fornire un contrasto sufficiente per la variante del logo selezionata.

Colore

Utilizza il testo grigio 700 di Materiale Google su uno sfondo bianco o chiaro che utilizza un intervallo di 0-40% di tinta massima di nero.

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

Su sfondi più scuri e su fotografie o motivi non troppo elaborati, utilizza il testo bianco per la firma 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 CSS, se applicato al testo "Google", mostrerà "Google" con carattere, colore e spaziatura appropriati su 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;