Norme e attribuzioni per l'API Geocoding

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

Norme

Questa sezione descrive le policy relative all'API Geocoding. Le norme forniscono linee guida e requisiti pratici per l'implementazione, per aiutarti a utilizzare il Servizio in modo corretto e in linea con le aspettative di Google Maps Platform.

Eccezioni alle limitazioni di memorizzazione nella cache

Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente dalle limitazioni di memorizzazione nella cache. Pertanto, puoi memorizzare i valori degli ID luogo a tempo indeterminato. L'ID luogo viene restituito nel campo place_id nelle risposte dell'API. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida agli ID luogo.

Filtro e riordinamento lato client

Puoi eseguire un filtro lato client nell'elenco di risultati di primo livello, ad esempio rimuovendo i risultati degli indirizzi che non corrispondono a criteri specifici per paese o codice postale. Puoi anche filtrare o riordinare le sottoliste contenute all'interno di un singolo risultato, ad esempio dando la priorità a determinati punti di navigazione, a condizione che i criteri di filtro o riordinamento non siano fuorvianti per gli utenti finali. Devi assicurarti che queste modifiche non rappresentino in modo ingannevole i dati originali restituiti dall'API.

Paesi e territori dello Spazio economico europeo

Questo prodotto ha Termini di servizio diversi per i clienti con un indirizzo di fatturazione nello Spazio economico europeo (SEE) e potrebbe anche avere funzionalità diverse. Prima di creare con Google Maps Platform, consulta i seguenti termini e informazioni specifici per il SEE:

• Termini di servizio di Google Maps Platform per il SEE
• Termini di servizio specifici di Google Maps Platform per il SEE
• Domande frequenti (FAQ) sul SEE
• Requisiti di sicurezza stradale di Google Maps Platform

Se il tuo indirizzo di fatturazione non si trova nel SEE, si applicano i seguenti Termini di servizio:

• Termini di servizio di Google Maps Platform
• Termini di servizio specifici di Google Maps Platform

Requisiti di attribuzione di Google Maps

Questa sezione fornisce i requisiti e le linee guida per l'attribuzione per la visualizzazione di Google Maps e dei contenuti tramite le tue applicazioni.

Nota: i seguenti requisiti di attribuzione aggiornati ora utilizzano "Google Maps" anziché solo "Google". Siamo consapevoli che le tue implementazioni esistenti potrebbero utilizzare l'attribuzione "Google", in linea con le indicazioni precedenti, e che potresti continuare a utilizzare "Google" come attribuzione per il momento. Per le nuove implementazioni, utilizza "Google Maps" come descritto in questa sezione. In futuro, forniremo tempistiche e istruzioni per aiutarti a eseguire la transizione delle attribuzioni "Google" esistenti alle attribuzioni "Google Maps".

Mostra l'attribuzione di Google Maps

Devi rispettare i requisiti di attribuzione di Google Maps quando mostri contenuti delle API di Google Maps Platform nella tua app o nel tuo sito web. Non è necessario aggiungere un'attribuzione aggiuntiva se i Contenuti vengono mostrati su una mappa di Google in cui l'attribuzione è già visibile.

Attribuzione di Google Maps inclusa

Per l'attribuzione di Google Maps già fornita da Google Maps Platform nell'interfaccia utente, ad esempio in Places UI Kit:

• Non rimuovere l'attribuzione inclusa, indipendentemente da dove viene visualizzata. Non alterare, nascondere o oscurare l'attribuzione e assicurati che sia chiaramente visibile sullo sfondo.
• Distingui sempre visivamente i Contenuti di Google Maps Platform dagli altri contenuti utilizzando indicatori dell'interfaccia utente come un bordo, un colore di sfondo, un'ombra o uno spazio vuoto sufficiente.
• Quando apporti modifiche visive, devi rispettare tutti i requisiti di attribuzione di Google Maps.

Logo di Google Maps e attribuzione del testo

L'attribuzione deve assumere la forma del logo di Google Maps, se possibile. Nei casi in cui lo spazio è limitato, è accettabile il testo Google Maps. Deve essere sempre chiaro agli utenti finali quali contenuti sono forniti da Google Maps.

A sinistra: esempio di attribuzione del logo di Google Maps, a destra: esempio di attribuzione del testo di Google Maps

Attribuzione del logo

Segui questi requisiti per l'utilizzo del logo di Google Maps nella tua app o nel tuo sito web.

Esempi di varianti accettabili per l'attribuzione del logo di Google Maps

Scarica i loghi di Google Maps

Utilizza i file del logo ufficiale di Google Maps. Scarica i loghi di seguito e segui le linee guida riportate in questa sezione.

Scarica gli asset di attribuzione di Google Maps

Quando utilizzi il logo di Google Maps, segui queste linee guida.

• Non modificare il logo in alcun modo.
• Mantieni le proporzioni del logo per evitare distorsioni.
• Utilizza il logo con contorno su uno sfondo elaborato, ad esempio una mappa o un'immagine.
• Utilizza il logo senza contorno su uno sfondo semplice, ad esempio un colore a tinta unita o un gradiente tenue.

Specifiche delle dimensioni del logo

Segui queste specifiche relative alle dimensioni per il logo di Google Maps:

• Altezza minima del logo: 16 dp
• Altezza massima del logo: 19 dp
• Spazio libero minimo del logo: 10 dp a sinistra, a destra e in alto, 5 dp in basso

Per scoprire di più sui dp, consulta la sezione Densità di pixel sul sito web di Material Design.

Esempio di logo di Google Maps che mostra lo spazio vuoto minimo e l'intervallo di dimensioni accettabili

Accessibilità del logo

Segui questi requisiti di accessibilità per il logo di Google Maps:

• Mantieni un contrasto accessibile tra il logo e lo sfondo.
• Includi un'etichetta di accessibilità con il testo Google Maps.

Esempi di varianti inaccettabili e problemi di accessibilità per l'attribuzione del logo di Google Maps

Attribuzione del testo

Se le dimensioni della tua interfaccia non supportano l'utilizzo del logo di Google Maps, puoi scrivere Google Maps in formato testo. Procedi nel seguente modo:

Esempi di varianti accettabili dell'attribuzione del testo di Google Maps

• Non modificare in alcun modo il testo Google Maps:
  
  • Non modificare l'uso delle maiuscole di Google Maps
  • Non mandare a capo Google Maps su più righe
  • Non localizzare Google Maps in un'altra lingua.
  • Impedisci ai browser di tradurre Google Maps utilizzando l'attributo HTML translate="no".

Esempi di varianti non accettabili dell'attribuzione del testo di Google Maps

• Applica uno stile al testo di Google Maps come descritto nella tabella seguente:

  Requisiti per lo stile del testo di Google Maps
  Proprietà	Stile
  Famiglia di caratteri	Roboto. Il caricamento del carattere è facoltativo.
  Famiglia di caratteri di riserva	Qualsiasi carattere sans serif per il corpo già utilizzato nel tuo prodotto o "Sans-Serif" per richiamare il carattere di sistema predefinito
  Stile carattere	Normale
  Spessore carattere	400
  Colore carattere	Bianco, nero (#1F1F1F) o grigio (#5E5E5E). Mantieni un contrasto accessibile (4,5:1) con lo sfondo.
  Dimensione carattere	Dimensione minima del carattere: 12 sp Dimensione massima del carattere: 16 sp Per scoprire di più su sp, consulta Unità di dimensione dei caratteri sul sito web di Material Design.
  Spaziatura tra le lettere	Normale

CSS di esempio

Il seguente CSS mostra Google Maps con lo stile tipografico e il colore appropriati su uno sfondo bianco o chiaro.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

Requisiti visivi

Segui questi requisiti per il trattamento visivo dell'attribuzione di Google Maps.

• Posiziona l'attribuzione vicino alla parte superiore o inferiore dei contenuti e all'interno dello stesso contenitore visivo. Per una singola riga di contenuti, l'attribuzione può essere posizionata a destra o a sinistra.

• Distingui visivamente i contenuti di Google Maps Platform da altri contenuti utilizzando indicatori dell'interfaccia utente come un bordo, un colore di sfondo, un'ombra o uno spazio vuoto sufficiente.

• Non rappresentare in modo ingannevole Google Maps attribuendogli contenuti non di Google Maps Platform.
• Verifica che l'attribuzione sia sempre visibile e leggibile. Non rimuoverlo, nasconderlo, oscurarlo o modificarlo.

Le seguenti immagini mostrano esempi di questi requisiti visivi.

Esempio di attribuzione di Google Maps posizionata in alto, in basso e a lato dei contenuti

Esempio di due approcci per differenziare i contenuti di Google Maps (la valutazione del luogo) da altri contenuti

Non oscurare l'attribuzione di Google Maps né mescolarla con contenuti di altre fonti

Fornitori di dati di terze parti

Alcuni dati e immagini dei nostri prodotti di mappatura provengono da fornitori diversi da Google. Per alcuni prodotti, come l'API Map Tiles, potremmo fornirti l'attribuzione richiesta al fornitore di dati di terze parti. In questo caso, il testo dell'attribuzione deve contenere il nome "Google Maps" e i fornitori di dati pertinenti, ad esempio "Dati mappa: Google, Maxar Technologies". Quando Google fornisce l'attribuzione di terze parti, l'inclusione di "Google Maps" o del logo Google non è un'attribuzione corretta.

Riepiloghi basati sull'AI (Destinations)

Quando mostri i riepiloghi basati sull'AI restituiti dal metodo SearchDestinations nella tua app, devi:

• Mostrare le attribuzioni, i link ai report e i link referenti richiesti, come definito in questa sezione.
• Assicurati che gli utenti finali possano leggere il testo completo del riepilogo così come viene fornito da Google Maps Platform.

Visualizza il testo dell'informativa sui riepiloghi basati sull'AI

Quando mostri un riepilogo basato sull'AI, includi sempre il testo dell'informativa localizzato fornito nel campo di risposta disclosureText immediatamente sotto il riepilogo. Non modificare o integrare mai il testo dell'informativa fornito dall'API.

Figura 1: testo dell'informativa visualizzato correttamente sotto i riepiloghi basati sull'AI.

Requisiti per il riepilogo dell'arrivo

I riepiloghi degli arrivi visualizzati nella tua app devono essere accompagnati dal seguente testo e dai link obbligatori:

Testo	Requisito
Informazioni su questo riepilogo	Utilizza il seguente link per "In che modo Google raccoglie e utilizza le informazioni nelle schede locali": https://support.google.com/local-listings/answer/9851099.
Riepilogo report	Utilizza il link contenuto nel campo flagContentUrl della risposta che ti consente di segnalare a Google un problema relativo ai contenuti di un riepilogo. Nota: i riepiloghi basati sull'AI forniti tramite l'API Geocoding sono soggetti alle norme relative ai contenuti e ai prodotti di Google, indipendentemente dalla tua posizione nel mondo. Devi informare gli utenti finali che, se vogliono segnalare contenuti che dovrebbero essere rimossi dai servizi di Google ai sensi delle leggi vigenti, devono farlo utilizzando l'URL per la segnalazione dei contenuti fornito, flagContentUrl.

Figura 2: riepilogo basato sull'AI mostrato con i link associati obbligatori messi a disposizione degli utenti finali tramite un menu extra.

Indicazioni relative ai display per i casi d'uso nel settore automobilistico

Per la sicurezza del conducente, Google consiglia di eseguire il rendering dei riepiloghi basati sull'AI in modalità parcheggio per le esperienze automobilistiche. Se i riepiloghi vengono visualizzati in modalità Guida, le informazioni sullo schermo devono essere chiare e concise per garantire che l'attenzione del conducente torni rapidamente alla strada:

• Non più di 3 righe
• 120 caratteri o 24 parole o meno
• Dimensioni minime del carattere di 24 dp

Soprattutto nei contesti automobilistici, è responsabilità dello sviluppatore eseguire il rendering dei riepiloghi basati sull'AI in modi sicuri e conformi a tutte le leggi e normative locali.