Norme e attribuzioni per l'API Places

Questo documento elenca i requisiti specifici per tutte le applicazioni sviluppate con l'API Places (New), incluso il servizio Autocomplete (New) che fa parte di questa API. Informazioni più generali per gli sviluppatori di Google Maps sono disponibili nei Termini di servizio di Google Maps Platform.

Norme

Questa sezione descrive le norme pertinenti all'API Places. Le norme forniscono linee guida e requisiti pratici per l'implementazione per aiutarti a utilizzare il Servizio correttamente e in linea con le aspettative di Google Maps Platform.

Eccezioni alle limitazioni della memorizzazione nella cache

Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente dalle limitazioni della memorizzazione nella cache. Pertanto, puoi memorizzare i valori dell'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.

Paesi e territori dello Spazio economico europeo

Questo prodotto ha Termini di servizio diversi per i clienti con 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 specifici del servizio per il SEE di Google Maps Platform
• 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 specifici del servizio per 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.

Visualizzare l'attribuzione di Google Maps

Quando visualizzi i contenuti delle API Google Maps Platform nella tua app o sul tuo sito web, devi rispettare i requisiti di attribuzione di Google Maps. 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 segnali dell'interfaccia utente come un bordo, un colore di sfondo, un'ombreggiatura o uno spazio bianco 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 dovrebbe 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.

Attribuzione del logo

Scaricare i loghi di Google Maps

Utilizza i file ufficiali del logo di Google Maps. Scarica i loghi riportati di seguito e segui le linee guida di questa sezione.

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 in contorno su uno sfondo elaborato, come una mappa o un'immagine.
• Utilizza il logo non contornato su uno sfondo semplice, ad esempio a tinta unita o con una sfumatura leggera.

Specifica delle dimensioni del logo

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

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

Accessibilità del logo

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

Attribuzione del testo

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

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

• Formatta il testo di Google Maps come descritto nella tabella seguente:

  Requisiti di stile del testo di Google Maps
  Proprietà	Stile
  Famiglia di caratteri	Roboto. Il caricamento del carattere è facoltativo.
  Famiglia di caratteri di riserva	Qualsiasi carattere del corpo sans-serif 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). Mantenere un contrasto accessibile (4,5:1) rispetto allo sfondo.
  Dimensione carattere	Dimensione minima del carattere: 12 sp Dimensione massima del carattere: 16 sp Per informazioni su sp, consulta Unità di misura della dimensione del carattere sul sito web Material Design.
  Spaziatura tra le lettere	Normale

CSS di esempio

Il seguente CSS esegue il rendering di 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

• 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 dagli altri contenuti utilizzando indicatori dell'interfaccia utente come un bordo, un colore di sfondo, un'ombreggiatura o uno spazio bianco 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 figure mostrano esempi di questi requisiti visivi.

Fornitori di dati di terze parti

Alcuni dei dati e delle 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 riportare il nome "Google Maps" e il nome del fornitore o dei fornitori di dati pertinente, ad esempio "Dati delle mappe: Google, Maxar Technologies". Quando Google fornisce l'attribuzione di terze parti, la semplice inclusione di "Google Maps" o del logo Google non è un'attribuzione corretta.

Requisiti aggiuntivi dell'API Places

I seguenti requisiti sono specifici per l'API Places.

Completamento automatico per gli indirizzi degli utenti finali

Quando un utente finale utilizza la funzionalità di completamento automatico all'interno della tua applicazione cliente per digitare in anticipo un indirizzo stradale e questo indirizzo stradale sarebbe stato fornito in modo completo e accurato dall'utente finale senza il completamento automatico, l'indirizzo selezionato dall'utente finale non è soggetto alle limitazioni dei contenuti di Google Maps nel tuo contratto Google Maps Platform. Questa eccezione si applica solo all'indirizzo civico selezionato dall'utente finale ed esclusivamente per la transazione specifica di quell'utente finale; non si applica all'elenco di indirizzi suggeriti fornito dalla funzionalità di completamento automatico o ad altri contenuti di Google Maps. Questa eccezione non si applica a nessuna funzionalità di ricerca di indirizzi o PDI offerta da altri servizi Google Maps Platform.

L'elenco degli indirizzi a sinistra è ancora soggetto alle limitazioni relative ai Contenuti di Google Maps. Una volta che l'utente finale seleziona l'indirizzo scelto, quest'ultimo non è soggetto alle limitazioni sui contenuti di Google Maps esclusivamente ai fini della transazione applicabile dell'utente finale.

Foto e recensioni

Attribuire tutti i contenuti all'autore dei contenuti

Quando mostri foto o recensioni, devi sempre citare l'autore. Ogni foto e recensione include l'attribuzione dell'autore (immagine avatar, nome e link al profilo dell'autore).

Requisiti visivi per l'attribuzione dell'autore:

• Attribuisci l'autore utilizzando tutte le risorse disponibili (avatar, nome e link al profilo) quando lo spazio lo consente.
• Per le recensioni, se lo spazio è limitato, il requisito minimo è la visualizzazione dell'avatar dell'autore.
• Per le foto, se lo spazio è limitato (ad esempio in una galleria o per le miniature), l'attribuzione dell'autore può essere omessa, a condizione che l'utente possa accedere a una versione più grande dell'immagine che include l'attribuzione completa dell'autore.
• Posiziona l'attribuzione dell'autore in modo che sia chiaramente associata alla foto o alla recensione dell'autore.

Fornire l'accesso diretto ai contenuti di origine su Google Maps

Per ogni foto e recensione, gli utenti finali devono sempre avere accesso alla visualizzazione della singola foto di origine o recensione su Google Maps utilizzando il googleMapsUri fornito.

Mostra la data di pubblicazione relativa (consigliato) *

La visualizzazione della data di pubblicazione relativa (ad esempio "2 giorni fa") per foto e recensioni utilizzando il relativePublishTimeDescription fornito aumenta la fiducia degli utenti nei contenuti.

Attiva i report sui contenuti (opzione consigliata) *

Le foto e le recensioni fornite tramite l'API Places sono soggette alle norme relative ai contenuti e ai prodotti di Google ovunque nel mondo. Tu e i tuoi utenti finali potete segnalare i contenuti che volete che vengano rimossi dai servizi di Google ai sensi delle norme di Google o delle leggi vigenti utilizzando il flagContentUri per ogni foto e recensione. In alternativa, i contenuti possono essere segnalati seguendo il link diretto ai contenuti su Google Maps, dove è disponibile anche la segnalazione di un problema.

Recensioni

Descrivere come vengono ordinate e filtrate le recensioni

Includi un avviso chiaro che descriva come vengono ordinate e filtrate le recensioni, inclusi eventuali criteri di ricerca applicati. Per impostazione predefinita, le recensioni sono ordinate in base alla pertinenza.

Mostra il mese e l'anno in cui i recensori hanno visitato luoghi in Francia

Quando vengono visualizzate le recensioni di luoghi in Francia e nei territori francesi, l'API Places restituisce un visitDate (il mese e l'anno in cui l'autore ha visitato il luogo), che deve essere visualizzato insieme ai contenuti.

Informa gli utenti finali quando le recensioni sono state tradotte (consigliato) *

Informare gli utenti finali quando una recensione è stata tradotta dalla lingua originale. Puoi consentire agli utenti finali di visualizzare il testo originale non tradotto originalText. In alternativa, possono seguire il link diretto ai contenuti su Google Maps, dove è disponibile il testo originale non tradotto.

Recensioni e valutazione media

Informa gli utenti finali su come Google verifica le recensioni (consigliato) *

Google non verifica le recensioni, ma controlla e rimuove i contenuti falsi quando vengono identificati. Informa gli utenti finali delle norme relative alle recensioni di Google quando mostri le recensioni e la valutazione media. Scopri di più sulle norme relative ai contenuti generati dagli utenti di Google Maps.

Riepiloghi basati sull'AI

Quando mostri riepiloghi basati sull'AI nella tua app, inclusi riepiloghi di luoghi, aree e recensioni, devi:

• Mostra le attribuzioni, i link ai report e i link di riferimento richiesti come definito di seguito.
• Gli utenti finali devono essere in grado di leggere il testo riepilogativo completo così come fornito da Google Maps.

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

Quando viene visualizzato un riepilogo basato sull'IA di qualsiasi tipo, includi sempre il testo dell'informativa localizzato (fornito nel campo disclosureText del corpo della risposta) immediatamente sotto il riepilogo. Non modificare o integrare mai il testo dell'informativa fornito dall'API.

Requisiti aggiuntivi per i riepiloghi di luoghi e aree

I riepiloghi di luoghi e aree visualizzati nella tua app devono essere accompagnati dal seguente testo e dai link obbligatori:

Requisiti per il riepilogo delle recensioni

I riepiloghi delle recensioni visualizzati nella tua app devono essere accompagnati da un titolo con il testo "Riepilogo recensioni". Inoltre, devi utilizzare il seguente testo e i seguenti link obbligatori:

Indicazioni per i casi d'uso automobilistici

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

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

Soprattutto in contesti automobilistici, è responsabilità dello sviluppatore eseguire il rendering dei riepiloghi basati sull'AI in modo sicuro e conforme a tutte le leggi e normative locali.

Risultati di ricerca di luoghi

Descrivi i fattori che influenzano il ranking dei risultati di ricerca (consigliato) *

Nel corso di un'interazione utente, gli utenti finali devono essere informati dei fattori principali e della ponderazione dei fattori principali che determinano il ranking dei risultati di ricerca.

Quando utilizzi la classificazione non modificata di Google, puoi visualizzare il seguente testo esplicativo:

"Quando cerchi attività o luoghi nelle vicinanze di una località, Google Maps mostra risultati di ricerca locale. Per trovare i risultati migliori per una ricerca, vengono combinati diversi fattori, principalmente pertinenza, distanza ed evidenza. Scopri di più."

Conformità con le leggi vigenti

Devi rispettare tutte le leggi vigenti in qualsiasi momento. Tieni presente che le pratiche etichettate come (consigliate) in queste norme potrebbero comunque essere imposte dalla legge. Inoltre, il rispetto di tutti i requisiti indicati e delle pratiche consigliate non garantisce la piena conformità legale in tutte le giurisdizioni. Se hai domande sul tuo stato di conformità, rivolgiti al tuo consulente legale.