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 e condizioni d'uso e le Norme sulla privacy con la tua applicazione che siano conformi alle linee guida definite nel tuo Contratto con Google:
- I Termini e condizioni d'uso e le Norme sulla privacy devono essere disponibili pubblicamente.
- Devi indicare esplicitamente nei Termini e condizioni d'uso della tua applicazione che gli utenti sono vincolati dai Termini di servizio di Google utilizzando l'applicazione.
- Devi informare gli utenti nelle tue Norme sulla privacy che stai utilizzando le API di Google Maps e incorporare, tramite riferimento, le Norme sulla privacy di Google.
La posizione consigliata in cui rendere disponibili i Termini e condizioni d'uso e le Norme sulla privacy dipende dalla piattaforma della tua applicazione.
App mobile
Se sviluppi 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 pertinente e in un menu delle impostazioni dell'applicazione.
Applicazioni web
Se sviluppi un'applicazione web, ti consigliamo di fornire un link ai Termini e condizioni d'uso e alle Norme sulla privacy nel piè di pagina del sito web.
Precaricamento, memorizzazione nella cache o archiviazione dei contenuti
Le applicazioni che utilizzano l'API Maps JavaScript sono vincolate dai termini del Contratto con Google. In base ai termini del Contratto, l'utente non deve precaricare, indicizzare, archiviare o memorizzare nella cache alcun Contenuto, se non nelle condizioni limitate indicate nei termini.
Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente dalle limitazioni relative 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 agli ID luogo.
Visualizzazione dei risultati dell'API Maps JavaScript
Puoi visualizzare i risultati dell'API Maps JavaScript su una mappa di Google Maps 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 Maps. È vietato utilizzare i dati dell'API Maps JavaScript su una mappa che non è una mappa di Google.
Visualizzazione del logo e delle attribuzioni di Google
Se l'applicazione visualizza dati su una mappa di Google Maps, verrà incluso il logo di Google che non potrà essere modificato. Per le applicazioni che visualizzano i dati di Google nella stessa schermata di una mappa di Google Maps non è necessario fornire ulteriori attribuzioni a Google.
Se l'applicazione mostra dati su una pagina o una visualizzazione che non mostra anche una mappa Google, devi mostrare un logo Google con tali dati. Ad esempio, se l'applicazione mostra dati di Google in una scheda e una mappa di Google con questi dati in un'altra scheda, nella prima scheda deve essere mostrato il logo di Google. Se l'applicazione utilizza campi di ricerca con o senza il completamento automatico, il logo deve essere visualizzato in linea.
Il logo di Google deve essere posizionato nell'angolo in basso a sinistra della mappa e le informazioni di attribuzione devono essere posizionate nell'angolo in basso a destra. In entrambi i casi, devono essere presentate nella mappa nel suo insieme e non sotto la mappa o un'altra posizione all'interno 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 sfondo scuro |
|---|---|
|
|
Il seguente file ZIP contiene il logo Google nelle dimensioni corrette per applicazioni desktop, 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 di attribuzione. Non puoi utilizzare i loghi Google incorporati (ad esempio "Queste mappe provengono da [Google_logo]").
Mantieni l'attribuzione concreta. Se utilizzi screenshot di immagini Google al di fuori degli incorporamenti 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 si trovi nelle vicinanze dei contenuti e sia leggibile per lo spettatore o il lettore medio. Non puoi spostare l'attribuzione dai contenuti, ad esempio alla fine del libro, dai riconoscimenti dei tuoi file o del tuo programma oppure dal piè di pagina del tuo sito web.
Includi fornitori di dati di terze parti. Alcuni dei dati e delle immagini sui nostri prodotti di mappatura provengono da fornitori diversi da Google. Se utilizzi immagini di questo tipo, il testo dell'attribuzione deve riportare il nome "Google" e i fornitori di dati pertinenti, ad esempio "Dati mappa: Google, Maxar Technologies". Quando esistono fornitori di dati di terze parti citati con le immagini, è possibile includere solo "Google" o il logo Google non è un'attribuzione appropriata.
Se utilizzi Google Maps Platform su un dispositivo in cui la visualizzazione dell'attribuzione non è pratica, contatta il team di vendita di Google per discutere delle licenze appropriate al tuo caso d'uso.
Altri requisiti di attribuzione
Segui queste istruzioni per recuperare le attribuzioni di terze parti e per visualizzarle nella tua app.
Recupera le attribuzioni da un luogo
Se la tua app mostra informazioni sulle recensioni ottenute chiamando
Place.fetchFields,
l'app deve mostrare anche le attribuzioni 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 valore List di String oggetti oppure null se
non ci sono attribuzioni da visualizzare. Il codice di esempio riportato di seguito mostra come trovare 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);
}
}
Mostra una recensione
Un oggetto Place può contenere fino a cinque recensioni, ognuna delle quali è rappresentata da un oggetto Review. Se vuoi, puoi visualizzare queste recensioni nella tua app.
Quando mostri recensioni fornite da utenti Google, devi posizionare il nome dell'autore nelle vicinanze. Se disponibile nel campo di attribuzione dell'autore dell'oggetto Review, ti consigliamo di includere anche la foto dell'autore e il link al suo profilo. La seguente immagine mostra un esempio di recensione di un parco:
L'esempio seguente mostra come trovare 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: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen, 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,
});
}
Mostra 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 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 o una stringa vuota se non ci sono attribuzioni da visualizzare.
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 intorno al logo completo deve essere uguale o superiore all'altezza della "G" in Google.
Lo spazio tra il testo dell'attribuzione e il logo di Google deve essere metà della larghezza della "G".
Leggibilità
La riga dell'autore deve essere sempre chiara, leggibile e con la giusta variazione di colore per un determinato sfondo. Assicurati sempre di offrire un contrasto sufficiente per la variante del logo selezionata.
Colore
Utilizza il testo Google Material Gray 700 su uno sfondo bianco o chiaro con una percentuale massima 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 con motivi fotografici o non occupati, utilizza il testo bianco per la riga dell'autore 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", mostra "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;