Questo argomento fornisce i requisiti di attribuzione per tutte le applicazioni sviluppate con l'API Maps JavaScript, incluso il servizio Place Autocomplete che fa parte di questa API. Per altri termini di Google Maps Platform, consulta i Termini di servizio di Google Maps Platform.
Fornire termini e condizioni d'uso e norme sulla privacy
Se sviluppi un'applicazione API Maps JavaScript, devi rendere disponibili i Termini di utilizzo e le Norme sulla privacy con la tua applicazione, che devono soddisfare le linee guida descritte nel tuo contratto con Google:
- I Termini e condizioni d'uso e le Norme sulla privacy devono essere disponibili pubblicamente.
- Devi dichiarare esplicitamente nei Termini e condizioni d'uso della tua applicazione che, utilizzandola, gli utenti sono vincolati ai Termini di servizio di Google.
- Devi informare gli utenti nelle tue Norme sulla privacy che utilizzi le API di Google Maps e incorporare per riferimento le Norme sulla privacy di Google.
Il luogo consigliato per rendere disponibili i Termini e condizioni d'uso e le Norme sulla privacy dipende dalla piattaforma della tua applicazione.
App per dispositivi mobili
Se stai sviluppando 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 di applicazioni pertinente e in un menu delle impostazioni dell'applicazione.
Applicazioni web
Se stai sviluppando un'applicazione web, ti consigliamo di fornire un link ai Termini di utilizzo e alle Norme sulla privacy a piè di pagina del tuo sito web.
Pre-fetching, memorizzazione nella cache o archiviazione di contenuti
Le applicazioni che utilizzano l'API Maps JavaScript sono vincolate dai termini del tuo contratto con Google. Fatte salve le condizioni del Contratto, non devi prelevare, indicizzare, memorizzare o memorizzare nella cache i Contenuti, salvo nei casi previsti dalle limitazioni indicate nei termini.
Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente da limitazioni alla memorizzazione nella cache. L'ID luogo viene restituito nel campo place_id nelle risposte dell'API Maps JavaScript. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida sugli ID luogo.
Visualizzazione dei risultati dell'API Maps JavaScript
Puoi visualizzare i risultati dell'API Maps JavaScript su una mappa Google o senza una mappa. Se vuoi visualizzare i risultati dell'API Maps JavaScript su una mappa, questi risultati devono essere visualizzati su una mappa di Google. È vietato utilizzare i dati dell'API Maps JavaScript su una mappa che non sia una mappa di Google.
Visualizzazione del logo e delle attribuzioni di Google
Se la tua applicazione mostra dati su una mappa di Google, il logo di Google sarà incluso e non potrà essere modificato. Le applicazioni che mostrano i dati di Google sulla stessa schermata di una mappa di Google non sono tenute a fornire un'ulteriore attribuzione a Google.
Se la tua applicazione mostra i dati in una pagina o una visualizzazione che non include anche una mappa di Google, devi mostrare un logo Google con i dati. Ad esempio, se la tua applicazione mostra i dati di Google in una scheda e una mappa di Google con questi dati in un'altra scheda, la prima scheda deve mostrare il logo di Google. Se la tua applicazione utilizza campi di ricerca con o senza completamento automatico, il logo deve essere visualizzato in linea.
Il logo Google deve essere posizionato nell'angolo in basso a sinistra della mappa, mentre le informazioni sull'attribuzione devono trovarsi nell'angolo in basso a destra. Entrambi devono essere sulla mappa presentata nel suo insieme e non sotto la mappa o in un altro punto dell'applicazione. Il seguente esempio di mappa mostra il logo di Google in basso a sinistra e l'attribuzione in basso a destra.
| Da utilizzare su uno sfondo chiaro | Da utilizzare su uno sfondo scuro |
|---|---|
|
|
Il seguente file ZIP contiene il logo di Google nelle dimensioni corrette per le applicazioni per computer, Android e iOS. Non puoi ridimensionare o modificare in alcun modo questi loghi.
Download: google_logo.zip
Non modificare l'attribuzione. Non rimuovere, oscurare o ritagliare le informazioni sull'attribuzione. Non puoi utilizzare i loghi di Google in linea (ad esempio, "Queste mappe provengono da [Google_logo]").
Mantieni l'attribuzione vicina. Se utilizzi screenshot delle immagini di Google al di fuori degli annunci incorporati 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 sia nelle immediate vicinanze dei contenuti e leggibile per lo spettatore o il lettore medio. Non puoi spostare l'attribuzione dai contenuti, ad esempio alla fine del libro, ai riconoscimenti dei tuoi file o del tuo programma o al piè di pagina del tuo sito web.
Includi fornitori di dati di terze parti. Alcuni dati e immagini dei nostri prodotti di mappatura provengono da fornitori diversi da Google. Se utilizzi queste immagini, il testo dell'attribuzione deve riportare il nome "Google" e i fornitori di dati pertinenti, ad esempio "Dati mappe: Google, Maxar Technologies". Se nelle immagini sono citati fornitori di dati di terze parti, l'inclusione solo di "Google" o del logo di Google non è un'attribuzione corretta.
Se utilizzi Google Maps Platform su un dispositivo su cui la visualizzazione dell'attribuzione non è pratica, contatta il team di vendita di Google per discutere delle licenze appropriate per il tuo caso d'uso.
Altri requisiti di attribuzione
Segui queste istruzioni per recuperare le attribuzioni di terze parti e visualizzarle nella tua app.
Recuperare le attribuzioni da un luogo
Se la tua app mostra le informazioni delle recensioni ottenute chiamando
Place.fetchFields,
l'app deve mostrare anche gli attributi di terze parti per i dettagli del luogo 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 e 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); } }
Visualizzare una recensione
Un oggetto Place può contenere fino a cinque recensioni, ciascuna rappresentata da un oggetto Review. Se vuoi, puoi mostrare queste recensioni nella tua app.
Quando mostri le recensioni inviate dagli utenti di Google, devi posizionare il nome dell'autore in prossimità. Se disponibile nel campo di attribuzione dell'autore dell'oggetto Review, 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 ottenere un luogo, controllare le recensioni e mostrare i dati della prima recensione:
// Use place ID to 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"], }); // If there are any reviews display the first one. if (!place.reviews) { console.log('No reviews were found.'); } else { // Log the review count so we can see how many there are. console.log("REVIEW COUNT: " + place.reviews.length); // Get info for the first review. let reviewRating = place.reviews[0].rating; let reviewText = place.reviews[0].text; let authorName = place.reviews[0].authorAttribution.displayName; let authorUri = place.reviews[0].authorAttribution.uri; // Create a bit of HTML to add to the info window const contentString = '<div id="title"><b>' + place.displayName + '</b></div>' + '<div id="address">' + place.formattedAddress + '</div>' + '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' + '<div id="rating">Rating: ' + reviewRating + ' stars</div>' + '<div id="rating""><p>Review: ' + reviewText + '</p></div>'; // Create an info window. infoWindow = new InfoWindow({ content: contentString, ariaLabel: place.displayName, }); // Add a marker for the place. const marker = new AdvancedMarkerElement({ map, position: place.location, title: place.displayName, }); // Show the info window. infoWindow.open({ anchor: marker, map, }); }
Consulta la documentazione relativa alle recensioni dei luoghi.
Visualizzare le attribuzioni di una foto
Se la tua app mostra foto, devi mostrare le attribuzioni dell'autore per ogni foto che le include.
I dettagli sulla 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 photos è 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 oppure una stringa vuota se non sono presenti
attribuzioni da visualizzare.
Consulta la documentazione relativa alle foto dei luoghi.
Attribuzioni dei risultati di ricerca
In Europa, quando si utilizza il ranking non alterato di Google, i prodotti di ricerca devono avere un testo esplicativo non più lontano di un clic che descriva i fattori principali e la loro ponderazione che determinano il ranking dei risultati di ricerca. Testo esplicativo:
Intestazione: Informazioni su questi risultati
Testo: 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
Linee guida di stile per l'attribuzione Google
Di seguito sono riportate le linee guida per gli stili per le attribuzioni di Google in CSS e HTML se non puoi utilizzare il logo di Google scaricabile.
Spazio vuoto
La quantità di spazio vuoto attorno al logo completo deve essere uguale o maggiore rispetto all'altezza della "G" di Google.
Lo spazio tra il testo dell'attribuzione e il logo di Google deve essere pari alla metà della larghezza della "G".
Leggibilità
Il nome dell'autore deve sempre essere chiaro, leggibile e nella variante di colore corretta per un determinato sfondo. Assicurati sempre di fornire un contrasto sufficiente per la variante del logo selezionata.
Colore
Utilizza il testo grigio 700 di Materiale Google su uno sfondo bianco o chiaro che utilizza una gamma di sfumature di nero compresa tra lo 0% e il 40%.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Su sfondi più scuri e su fotografie o motivi non troppo elaborati, utilizza il testo bianco per la firma e l'attribuzione.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Carattere
Utilizza il carattere Roboto.
CSS di esempio
Il seguente CSS, se applicato al testo "Google", mostrerà "Google" con carattere, colore e spaziatura appropriati su 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;