Norme e attribuzioni per l'API Maps JavaScript

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

Norme

Questa sezione descrive le policy relative all'API Maps JavaScript. 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.

Scraping dei contenuti

Il nome del luogo potrebbe essere restituito in base alle interazioni degli utenti con la tua app. Se acquisisci o conservi il nome del luogo per utilizzarlo in un altro contesto al di fuori della sessione utente, si tratta di scraping, che non è consentito dai nostri termini.

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.

Esempio di attribuzione

Di seguito è riportato un esempio di attribuzione per Places UI Kit.

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.

Attribuzione del logo

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.

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

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

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 della tua interfaccia non supportano l'utilizzo del logo di Google Maps, puoi scrivere Google Maps in formato testo. Procedi nel seguente modo:

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

• 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

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

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.

Altri requisiti di attribuzione

Segui queste istruzioni per recuperare le attribuzioni di terze parti e visualizzarle nella tua app.

Recupera le attribuzioni da un luogo

Se la tua app mostra informazioni sulle recensioni ottenute chiamando Place.fetchFields, deve anche mostrare le attribuzioni di terze parti per i Place Details ottenuti.

L'API restituisce un oggetto Place. Per recuperare le attribuzioni dall'oggetto Place, utilizza la proprietà Place.attributions, che viene restituita con ogni richiesta (non è necessario specificarla con i campi). La proprietà restituisce un List di oggetti String o null se non sono presenti attribuzioni da visualizzare. Il seguente codice di esempio mostra come ottenere un luogo ed elencare eventuali attribuzioni.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

Visualizza una recensione

Un oggetto Place può contenere fino a cinque recensioni, ognuna delle quali è rappresentata da un oggetto Review. Se vuoi, puoi mostrare queste recensioni nella tua app.

Quando mostri le recensioni fornite dagli utenti Google, devi inserire il nome dell'autore nelle immediate vicinanze. Se disponibili nel campo di attribuzione dell'autore dell'oggetto Review, ti consigliamo di includere anche la foto dell'autore e il link al suo profilo. L'immagine seguente mostra un esempio di recensione di un parco:

L'esempio seguente mostra come recuperare un luogo, verificare la presenza di recensioni e mostrare i dati della prima recensione:

// Create a new Place instance.
const place = new Place({
    id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA
});

// Call fetchFields, passing 'reviews' and other needed fields.
await place.fetchFields({
    fields: ['displayName', 'formattedAddress', 'location', 'reviews'],
});

// Create an HTML container.
const content = document.createElement('div');
const title = document.createElement('div');
const rating = document.createElement('div');
const address = document.createElement('div');
const review = document.createElement('div');
const authorLink = document.createElement('a');

// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
    // Get info for the first review.
    const reviewRating = place.reviews[0].rating;
    const reviewText = place.reviews[0].text;
    const authorName = place.reviews[0].authorAttribution.displayName;
    const authorUri = place.reviews[0].authorAttribution.uri;

    // Safely populate the HTML.
    title.textContent = place.displayName || '';
    address.textContent = place.formattedAddress || '';
    rating.textContent = `Rating: ${reviewRating} stars`;
    review.textContent = reviewText || '';
    authorLink.textContent = authorName;
    authorLink.href = authorUri || '';
    authorLink.target = '_blank';

    content.appendChild(title);
    content.appendChild(address);
    content.appendChild(rating);
    content.appendChild(review);
    content.appendChild(authorLink);
} else {
    content.textContent = `No reviews were found for ${place.displayName}.`;
}

// Create an infoWindow to display the review.
infoWindow = new InfoWindow({
    content,
    ariaLabel: place.displayName,
});
index.js

Consulta la documentazione relativa alle recensioni dei luoghi.

Visualizza le attribuzioni di una foto

Se la tua app mostra foto, devi mostrare le attribuzioni dell'autore per ogni foto che le contiene. I dettagli della foto in un oggetto Place di una risposta sono contenuti nell'array photos. Per aggiungere l'array photos alla risposta, includi il campo di dati photos nella richiesta.

Ogni elemento dell'array di foto è un'istanza di Photo, che contiene l'array authorAttributions, di tipo AuthorAttribution. I campi dell'oggetto AuthorAttribution sono stringhe contenenti displayName, uri e photoUri dell'attribuzione o una stringa vuota se non sono presenti attribuzioni da visualizzare.

Consulta la documentazione per le foto dei luoghi.

Attribuzioni dei risultati di ricerca

In Europa, quando si utilizza il ranking non modificato di Google, i prodotti di ricerca devono avere un testo esplicativo a non più di un clic di distanza che descriva i fattori principali e la ponderazione dei fattori principali che determinano il ranking dei risultati di ricerca. Testo esplicativo:

Intestazione: Informazioni su questi risultati

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

Pulsante 1: Scopri di più
Il testo "Scopri di più" deve rimandare a un articolo del Centro assistenza.

Pulsante 2: OK

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 nel tuo Contratto di Google Maps Platform. Questa eccezione si applica solo alla via selezionata dall'utente finale ed esclusivamente 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.

Nell'immagine precedente, 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.

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

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

Requisiti aggiuntivi per i riepiloghi di luoghi e aree

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

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:

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