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 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 nella tua applicazione, che sia conforme alle linee guida definite nel Contratto con Google:

  • I Termini e condizioni d'uso e le Norme sulla privacy devono essere disponibili pubblicamente.
  • Devi indicare esplicitamente nei Termini e condizioni d'uso della tua applicazione che gli utenti sono vincolati dai Termini di servizio di Google utilizzando l'applicazione.
  • Devi informare gli utenti nelle tue Norme sulla privacy che stai utilizzando le API di Google Maps e incorporare, tramite 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 della tua applicazione.

App mobile

Se sviluppi 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 pertinente e in un menu delle 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 sito web.

Precaricamento, memorizzazione nella cache o archiviazione dei contenuti

Le applicazioni che utilizzano l'API Map Tiles sono vincolate dai termini del Contratto con Google. In base ai termini del Contratto, l'utente non deve precaricare, indicizzare, archiviare o memorizzare nella cache alcun Contenuto, se non nelle 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 non di visualizzazione, ad esempio:

  • Analisi delle immagini
  • Interpretazione automatica
  • Rilevamento/identificazione degli oggetti
  • Estrazione o rivendita di dati geografici
  • Usi offline, inclusi quelli per gli utenti sopra indicati

Le risposte dell'API Map Tiles possono includere intestazioni Cache-Control che devono essere implementate secondo la documentazione sul protocollo HTTP. Ad esempio, il 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 quando si richiede la riconvalida.

Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente dalle limitazioni relative 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 agli ID luogo.

Quando utilizzi l'API Map Tiles per visualizzare Google Maps, devi anche mostrare il logo di Google sulla mappa e non 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. Per saperne di più, consulta le nostre linee guida del Centro risorse del brand.

Nel caso di mappe 3D più cinematografiche, ovvero se i tuoi requisiti di progettazione dell'esperienza utente non sono facilmente conformi a 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 dei 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 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 ritagliare le informazioni di attribuzione. Non puoi utilizzare i loghi Google incorporati (ad esempio "Queste mappe provengono da [Google_logo]").

Mantieni l'attribuzione concreta. Se utilizzi screenshot di immagini 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 dell'attribuzione, a condizione che il testo si trovi nelle vicinanze dei contenuti e sia leggibile per lo spettatore o il lettore medio. Non puoi spostare l'attribuzione dai contenuti, ad esempio alla fine del libro, dai riconoscimenti dei tuoi file o del tuo programma oppure dal piè di pagina del tuo sito web.

Includi fornitori di dati di terze parti. Alcuni dei dati e delle immagini sui nostri prodotti di mappatura provengono da fornitori diversi da Google. Se utilizzi immagini di questo tipo, il testo dell'attribuzione deve riportare il nome "Google" e i fornitori di dati pertinenti, ad esempio "Dati mappa: Google, Maxar Technologies". Quando esistono fornitori di dati di terze parti citati con le immagini, è possibile includere solo "Google" o il logo Google non è un'attribuzione appropriata.

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 al 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 devi sovrapporre o oscurare il logo Google con altri loghi, ad esempio quello del renderer. Mantieni una distanza ragionevole tra il logo di Google e il logo 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 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 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 del set di riquadri visualizzato 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 mostrare le attribuzioni dei dati per intero a causa di limiti di dimensioni dell'area visibile, valuta la possibilità di aggiungere un elemento UI cliccabile o con il passaggio del mouse sopra l'etichetta "Origini dati", che si apre nella finestra della mappa per fornire informazioni sulle attribuzioni. 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 dei dati di terze parti

Quando utilizzi l'API Map Tiles per visualizzare i dati di Google Maps come mappa 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 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 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 base e tra di loro.

Mostrare le attribuzioni di logo e dati in visualizzazioni ibride

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

Ad esempio, puoi combinare riquadri 3D fotorealistici (come riempitivo dello sfondo) con i tuoi modelli fotorealistici (in primo piano). Gli utenti potrebbero essere confusi 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 ha origine dai dati di Google Maps. Sei responsabile del rispetto di 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

È possibile sovrapporre oggetti 3D di tua proprietà su riquadri 3D fotorealistici, purché gli oggetti 3D non siano estratti, tracciati o altrimenti ricavati a mano o a macchina da riquadri 3D fotorealistici.

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 come "solo a fini 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.

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

Riquadri 2D

Roadmap, riquadri satellitari e rilievi

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 su copyright e 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 in Street View, è esente dalle restrizioni per la memorizzazione nella cache. Di conseguenza, puoi memorizzare i valori degli ID panoramica in modo indefinito. 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 nel codice 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,
    }));

Cesio per Unreal

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

Come abilitare le attribuzioni per Cesium for Unreal

Cesio per Unity

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

Come attivare le attribuzioni per Cesium for Unity

Linee guida di stile per l'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 metà della larghezza della "G".

Leggibilità

La riga dell'autore deve essere sempre chiara, leggibile e con 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 lo 0% e il 40%.

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

Su sfondi più scuri e con motivi fotografici o non occupati, utilizza il 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 CSS, quando applicato al testo "Google", mostra "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;