Questo documento elenca i requisiti specifici per tutte le applicazioni sviluppate con l'API Places, incluso il servizio Place Autocomplete 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.
Fornire termini e condizioni d'uso e norme sulla privacy
Se sviluppi un'applicazione API di Places, 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 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 Places 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 Places. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida sugli ID luogo.
Visualizzazione dei risultati dell'API Places
Puoi visualizzare i risultati dell'API Places su una mappa di Google o senza una mappa. Se vuoi visualizzare i risultati dell'API Places su una mappa, questi risultati devono essere visualizzati su una mappa di Google. È vietato utilizzare i dati dell'API Places 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 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 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.
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 per visualizzarle nella tua app.
Recuperare le attribuzioni da un luogo
Se la tua app mostra informazioni ottenute chiamando Dettagli dei luoghi con un ID luogo, deve anche mostrare le attribuzioni di terze parti per i dettagli dei luoghi ottenuti.
Le attribuzioni nell'oggetto
Place
di una risposta sono rappresentate da un oggetto
Attribution. Per aggiungere Attribution alla risposta, includi places.attributions (Ricerca nelle vicinanze e Ricerca di testo) o attributions (Dettagli dei luoghi) nella maschera di campo della richiesta.
I campi dell'oggetto Attribution sono stringhe contenenti provider
e providerUri dell'attribuzione oppure una stringa vuota se non sono presenti attribuzioni da visualizzare.
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
Place
oggetto di una risposta sono contenuti nell'array photos. Per aggiungere l'array photos alla risposta, includi places.photos (Ricerca nelle vicinanze e Ricerca di testo) o photos (Dettagli dei luoghi) nella maschera di campo della 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.
Visualizzare una recensione
Un oggetto Place
in una risposta può contenere fino a cinque recensioni. Se vuoi, puoi mostrare queste recensioni nella tua app.
Quando mostri le recensioni inviate dagli utenti di Google, devi posizionare il nome dell'autore nelle immediate 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. L'immagine seguente mostra un esempio di recensione di un parco:
Google consiglia inoltre di mostrare all'utente finale il modo in cui le recensioni vengono ordinate.
Ogni recensione in un
Place
oggetto di una risposta è rappresentata da un
Review
oggetto. Per aggiungere l'oggetto Review alla risposta, includi places.reviews (Ricerca nelle vicinanze e Ricerca di testo) o reviews (Dettagli dei luoghi) nella maschera di campo della richiesta.
I campi dell'oggetto Review contengono l'attribuzione o sono vuoti se non c'è alcuna attribuzione da visualizzare.
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
Riepiloghi basati sull'IA
Quando nella tua app mostri riepiloghi basati sull'IA, tra cui riepiloghi di luoghi, aree e recensioni, devi:
- Mostrare le attribuzioni, i link ai report e i link di riferimento obbligatori come definito di seguito.
- Gli utenti finali devono essere in grado di leggere il testo completo del riepilogo fornito da Google Maps.
Mostrare il testo di avviso relativo ai riepiloghi basati sull'IA
Quando mostri un riepilogo basato sull'IA di qualsiasi tipo, includi sempre il testo dell'informativa localizzato (fornito nel campo disclosureText del corpo della risposta) subito sotto il riepilogo. Non modificare o integrare mai il testo dell'informativa fornito dall'API.
Requisiti aggiuntivi per riepiloghi di luoghi e aree
I riepiloghi di luoghi e di aree visualizzati nella tua app devono essere accompagnati dal seguente testo e dai link obbligatori:
| Testo | Requisito |
|---|---|
| Informazioni su questo riepilogo | Utilizza il seguente link per consultare la pagina "Informazioni su come 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 Nota:i riepiloghi basati sull'IA forniti tramite l'API Places (nuova) sono soggetti alle norme relative ai contenuti e ai prodotti di Google ovunque ti trovi nel mondo. Devi informare gli utenti finali che, se vogliono segnalare contenuti che devono essere rimossi dai servizi Google ai sensi delle leggi vigenti, devono utilizzare l'URL dei contenuti segnalati fornito ( |
Requisiti dei riepiloghi delle recensioni
I riepiloghi delle recensioni visualizzati nella tua app devono essere accompagnati da un'intestazione con il testo "Riepilogo della recensione". Inoltre, devi utilizzare il seguente testo e i link obbligatori:
| Testo | Requisito |
|---|---|
| Informazioni su questo riepilogo | Utilizza il seguente link a "Informazioni su come 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 Nota:i riepiloghi basati sull'IA forniti tramite l'API Places (nuova) sono soggetti alle norme relative ai contenuti e ai prodotti di Google ovunque ti trovi nel mondo. Devi informare gli utenti finali che, se vogliono segnalare contenuti che devono essere rimossi dai servizi Google ai sensi delle leggi vigenti, devono utilizzare l'URL dei contenuti segnalati fornito ( |
| Visualizza le recensioni | Utilizza il link contenuto nel campo googleMapsLinks.reviewsUri della risposta. |
Indicazioni per i display per i casi d'uso nel settore auto e motori
Per la sicurezza del conducente, Google consiglia di eseguire il rendering dei riepiloghi basati sull'IA in modalità parcheggiata per le esperienze nel settore auto e motori. Se vengono visualizzati riepiloghi in modalità di guida, le informazioni sullo schermo devono essere semplici, chiare e concise per garantire che l'attenzione del conducente ritorni rapidamente alla strada:
- Non più di 3 righe
- Massimo 120 caratteri o 24 parole
- Dimensioni minime anteriori di 24 dp
Soprattutto in contesti automobilistici, è responsabilità dello sviluppatore visualizzare i riepiloghi basati sull'IA in modo sicuro e conforme a tutte le leggi e normative locali.
Linee guida di stile per l'attribuzione Google
Di seguito sono riportate le linee guida per gli stili delle 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;