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 ulteriori 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.
- Nei Termini e condizioni d'uso della tua applicazione devi indicare esplicitamente che gli utenti sono vincolati dai Termini di servizio di Google se utilizzano la tua applicazione.
- Nelle tue Norme sulla privacy devi informare gli utenti che utilizzi le API di Google Maps e incorporare tramite riferimento le Norme sulla privacy di Google.
Il luogo consigliato per rendere disponibili i tuoi Termini e condizioni d'uso e 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.
Prelettura, memorizzazione nella cache o archiviazione di contenuti
Le applicazioni che utilizzano l'API Maps JavaScript sono vincolate dai termini del tuo contratto con Google. Fatto salvo quanto stabilito nei termini del Contratto, non devi prelevare, indicizzare, memorizzare o memorizzare nella cache alcun Contenuto, salvo nelle condizioni limitate 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 mostra 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 Google in basso a sinistra nella mappa e l'attribuzione in basso a destra.
| Per l'utilizzo su uno sfondo chiaro | Da utilizzare su 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.
Scarica: 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,
deve anche mostrare 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); } }
Mostrare una recensione
Un oggetto Place può contenere fino a cinque recensioni, ciascuna rappresentata da un oggetto Review. Facoltativamente, puoi mostrare queste recensioni nella tua app.
Quando visualizzi recensioni fornite da utenti di Google, devi avvicinare
il nome dell'autore. Se disponibile nel campo di attribuzione dell'autore dell'oggetto Review, consigliamo di includere anche la foto e il link al profilo dell'autore. 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 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 oppure una stringa vuota se non sono presenti
attribuzioni da visualizzare.
Consulta la documentazione per le foto del luogo.
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 di stile per le attribuzioni di Google in CSS e HTML se non riesci a 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 avere la 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 un intervallo di 0-40% di tinta massima di nero.
#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, quando applicato al testo "Google", mostrerà "Google" con il carattere, il colore e la spaziatura appropriati su uno 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;