Norme e attribuzioni per l'API Places

Questo documento elenca i requisiti specifici per tutte le applicazioni sviluppate con l'API Places (nuova), incluso il servizio Autocomplete (nuovo) 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 relative all'API Places. 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.

Archiviazione, memorizzazione nella cache e scraping dei dati

Quando utilizzi i contenuti di Google Maps nella tua applicazione, segui i requisiti di gestione dei dati indicati nella sezione 3.2.3 dei Termini di servizio di Google Maps Platform e nei Termini di servizio specifici di Google Maps Platform:

  • Limitazioni relative alla memorizzazione nella cache e allo scraping (Sezione 3.2.3(a) e (b)): memorizza nella cache o archivia i Contenuti di Google Maps solo se espressamente consentito dai Termini di servizio specifici di Google Maps Platform. Non esportare, estrarre o effettuare scraping dei Contenuti di Google Maps per utilizzarli al di fuori dei Servizi. Ad esempio, non eseguire il pre-caricamento, l'indicizzazione, l'archiviazione o la ridistribuzione dei Contenuti di Google Maps al di fuori dei Servizi; non scaricare in blocco i riquadri della mappa, le immagini di Street View, i geocodici, le indicazioni stradali, i risultati di Distance Matrix, le informazioni sulle strade, le informazioni sui luoghi, i valori di altitudine o i dettagli del fuso orario; non copiare e salvare nomi di attività, indirizzi o recensioni degli utenti.
  • Limitazioni relative ai contenuti derivati (sezione 3.2.3(c)): utilizza i contenuti di Google Maps all'interno della tua applicazione come consentito dai Termini di servizio di Google Maps Platform. Non creare contenuti basati sui Contenuti di Google Maps. Ad esempio, non tracciare o digitalizzare elementi da immagini satellitari, creare modelli 3D o del terreno, utilizzare i valori di latitudine e longitudine di Places come input per l'analisi point-in-polygon, creare un indice di località da immagini di Street View o convertire i tempi di percorrenza basati su testo in sintesi vocale.

Per ridurre la latenza e i costi di fatturazione senza memorizzare nella cache i dati limitati, utilizza maschere di campo o elenchi di campi per richiedere solo i campi necessari alla tua interfaccia utente. Archivia gli identificatori esenti, come l'ID luogo, per recuperare dettagli aggiornati quando un utente interagisce con un luogo.

I tecnici dell'assistenza tecnica di Google non possono fornire consulenza legale o concedere eccezioni ai Termini di servizio di Google Maps Platform. Rivolgiti al tuo consulente legale per determinare se la tua implementazione è conforme ai termini o contatta il team di vendita se il tuo caso d'uso richiede licenze personalizzate.

Eccezioni alle limitazioni di memorizzazione nella cache

I Termini di servizio specifici di Google Maps Platform concedono le seguenti eccezioni limitate alla memorizzazione nella cache:

  • ID luogo: L'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente da le restrizioni di caching. Pertanto, puoi memorizzare i valori degli ID luogo a tempo indeterminato. Gli ID luogo vengono restituiti nel campo id o place_id nelle risposte dell'API. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida agli ID luogo.
  • Coordinate di latitudine e longitudine: puoi memorizzare temporaneamente nella cache i valori di latitudine (latitude) e longitudine (longitude) per un massimo di 30 giorni di calendario consecutivi, dopodiché devi eliminare le coordinate memorizzate nella cache, quando utilizzi servizi che concedono questa eccezione nei Termini di servizio specifici di Google Maps Platform:
    • API Routes, API Route Optimization, API Directions (legacy) e API Roads
    • API Geocoding, API Geolocation e API Address Validation
    • API Places, Places UI Kit e SDK di navigazione
  • Periodi di memorizzazione nella cache specifici per i servizi: i Termini specifici dei servizi di Google Maps Platform definiscono anche i periodi di memorizzazione nella cache specifici per i campi e gli scopi consentiti per l'API Address Validation, l'API Air Quality, l'API Pollen, l'API Solar, l'API Weather e l'API Places Aggregate.

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:

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

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.

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 ulteriori attribuzioni 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.

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: attribuzione del logo di Google Maps, a destra: attribuzione del testo di 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.
Varianti accettabili per l'attribuzione del logo di Google Maps
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.

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

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.
Variazioni inaccettabili e problemi di accessibilità per l'attribuzione del logo di 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:

Varianti accettabili dell'attribuzione del testo di Google Maps
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".
Varianti non accettabili dell'attribuzione del testo di Google Maps
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ù sugli sp, consulta la sezione Unità di misura delle dimensioni 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 dagli 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 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
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é combinarla con contenuti di altre fonti
Non oscurare l'attribuzione di Google Maps né mescolarla con contenuti di altre fonti

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 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.

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 un indirizzo e questo indirizzo 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 previste dal tuo Contratto Google Maps Platform. Questa eccezione si applica solo alla via selezionata dall'utente finale e unicamente per la transazione specifica di quell'utente finale; non si applica all'elenco di indirizzi suggeriti forniti dalla funzionalità di completamento automatico o ad altri Contenuti di Google Maps. Questa eccezione non si applica alle funzionalità di ricerca di PDI o indirizzi offerte da altri servizi di Google Maps Platform.

Completamento automatico dell'indirizzo dell'utente finale

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

Foto e recensioni

Attribuisci tutti i contenuti all'autore dei contenuti

Devi sempre citare l'autore quando mostri foto o recensioni. Ogni foto e recensione include un'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 è mostrare l'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 includa l'attribuzione completa dell'autore.
  • Posiziona l'attribuzione dell'autore in modo che sia chiaramente associata alla foto o alla recensione dell'autore.
Attribuzione dell'autore visualizzata nell'angolo in alto a sinistra della foto e della recensione
Esempio di attribuzione dell'autore visualizzata nell'angolo in alto a sinistra della foto e della recensione

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 o recensione di origine su Google Maps utilizzando il googleMapsUri fornito.

Menu verticale con link per visualizzare la foto o la recensione di origine su Google Maps
Esempio di menu verticale con link per visualizzare la foto di origine o la recensione su Google Maps

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.

Le foto e le recensioni fornite tramite l'API Places (nuova) e l'API Places (legacy) 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 di cui volete richiedere la rimozione 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

Descrivi 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 per pertinenza.

Avviso che descrive l'ordine delle recensioni
Esempio di avviso che descrive l'ordine delle recensioni

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

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

Data della visita visualizzata sotto una recensione utente
Esempio della data della visita visualizzata sotto una recensione utente

Informa 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.

Avviso di traduzione visualizzato sotto una recensione utente
Esempio di avviso di traduzione visualizzato sotto una recensione utente

Recensioni e valutazione media

Google non verifica le recensioni, ma controlla e rimuove i contenuti falsi se vengono identificati. Informare 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.

Esempio di avviso che descrive le norme relative alle recensioni di Google
Esempio di avviso che descrive le norme relative alle recensioni di Google

Riepiloghi basati sull'AI

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

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

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

Quando mostri un riepilogo basato sull'AI 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.

Informativa per tutti i tipi di riepiloghi basati sull'AI
Testo dell'informativa visualizzato correttamente sotto ciascuno dei tre tipi di riepilogo basati sull'AI

Requisiti aggiuntivi per i riepiloghi di luoghi e aree

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

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 flagContentUri della risposta per consentire la segnalazione a Google di un problema relativo ai contenuti di un riassunto.

Nota: i riepiloghi basati sull'AI forniti tramite l'API Places (nuova) sono soggetti alle norme su prodotti e contenuti di Google ovunque nel mondo. Sei tenuto a informare i tuoi utenti finali che, se vogliono segnalare contenuti di cui richiedere la rimozione dai servizi di Google ai sensi delle leggi vigenti, devono farlo utilizzando l'URL per la segnalazione dei contenuti fornito (flagContentUri).

Informativa per i riepiloghi di luoghi e aree
Riepilogo dell'area basato sull'AI mostrato con i link associati richiesti resi disponibili agli utenti finali tramite un menu extra

Requisiti per i riepiloghi delle recensioni

I riepiloghi delle recensioni visualizzati nella tua app devono essere accompagnati da un'intestazione con il testo "Riepilogo delle recensioni". Inoltre, devi utilizzare il seguente testo e i 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 flagContentUri della risposta.

Nota: i riepiloghi basati sull'AI forniti tramite l'API Places (nuova) sono soggetti alle norme su prodotti e contenuti di Google ovunque nel mondo. Sei tenuto a informare i tuoi utenti finali che, se vogliono segnalare contenuti di cui richiedere la rimozione dai servizi di Google ai sensi delle leggi vigenti, devono farlo utilizzando l'URL per la segnalazione dei contenuti fornito (flagContentUri).

Visualizza le recensioni Utilizza il link contenuto nel campo reviewSummary.reviewsUri della risposta.
Informativa per i riepiloghi delle recensioni
Riepilogo delle recensioni 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.

Risultati di ricerca di luoghi

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

Quando utilizzi il ranking non modificato di Google, puoi mostrare 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ù."

Informativa per i risultati di ricerca di luoghi
Finestra di dialogo che descrive in che modo Google determina il ranking dei risultati di ricerca

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 obbligatorie per 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.