Questo argomento fornisce i requisiti di attribuzione per tutte le applicazioni sviluppato con l'SDK Places per Android, incluso Place Autocomplete che fa parte di quell'API. Per altri termini relativi a Google Maps Platform, consulta i Termini di servizio di Google Maps Platform.
Fornendo Termini e condizioni d'uso e norme sulla privacy
Se sviluppi un'applicazione Places SDK for Android, devi rendere disponibile Termini di utilizzo e Privacy Norme con la tua applicazione che soddisfi le linee guida definite nel tuo Contratto con Google:
- I Termini e condizioni d'uso e le norme sulla privacy devono essere pubblici disponibili.
- Devi indicare esplicitamente nei Termini e condizioni d'uso della tua applicazione che utilizzando la tua applicazione, gli utenti sono vincolati Termini di servizio di Google servizio.
- Nelle Norme sulla privacy devi informare gli utenti che utilizzi l'API di Google Maps e incorporare, mediante riferimento, le Norme sulla privacy di Google.
Ti consigliamo di rendere disponibili i tuoi Termini e condizioni d'uso e Le norme sulla privacy dipendono dalla piattaforma dell'applicazione.
App per dispositivi mobili
Se stai sviluppando un'app mobile è consigliabile fornire un link al Termini e condizioni d'uso e Norme sulla privacy nella tua applicazione pagina di download nello store pertinente e nelle impostazioni dell'applicazione o dal menu Fogli Google.
Applicazioni web
Se stai sviluppando un'applicazione web è consigliabile fornire un link a i Termini e condizioni d'uso e le Norme sulla privacy nel piè di pagina della sito web.
Prelettura, memorizzazione nella cache o archiviazione di contenuti
Le applicazioni che utilizzano Places SDK per Android sono vincolate dai termini del Contratto con Google. In base ai termini del tuo Contratto, non devi precaricare, indicizzare, archiviare o memorizzare nella cache qualsiasi Contenuto, ad eccezione dei condizioni dichiarate nei termini.
Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, esente dalle restrizioni di memorizzazione nella cache. L'ID luogo viene restituito nel campo "place_id" in Risposte dell'SDK Places per Android. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida agli ID luogo.
Visualizzazione dei risultati di Places SDK per Android
Puoi visualizzare i risultati di Places SDK per Android su una mappa di Google o senza mappa. Se vuoi mostrare i risultati di Places SDK per Android su una mappa, questi risultati devono essere visualizzati su una mappa di Google. È vietato utilizzare i dati di Places SDK per Android su una mappa che non sia una mappa di Google.
Visualizzazione del logo e delle attribuzioni di Google
Se la tua applicazione visualizza dati su una mappa di Google, il team verrà incluso e non potrà essere modificato. Applicazioni che mostrano dati di Google nella stessa schermata di una mappa di Google non sono tenuti a fornire ulteriori attribuzioni a Google.
Se la tua applicazione visualizza dati in una pagina o una vista che non visualizzare anche una mappa di Google, devi mostrare un logo Google con quei dati. Ad esempio: se l'applicazione visualizza dati di Google in una scheda e una mappa di Google con tali dati in un'altra scheda, la prima deve mostrare il logo 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, con l'attribuzione informazioni posizionate nell'angolo in basso a destra, che dovrebbero essere entrambe sulla mappa presentati nel suo insieme e non sotto la mappa o in un altro punto all'interno dell'applicazione. La l'esempio di mappa seguente mostra il logo di Google in basso a sinistra della mappa e l'attribuzione in basso a destra.
![posizionamento attribuzione criteri](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/policies_attribution_placement.png?authuser=5&hl=it)
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 desktop, Android e iOS. Non puoi ridimensionare o modificare questi loghi in qualsiasi modo.
Scarica: google_logo.zip
Non modificare l'attribuzione. Non rimuovere, oscurare o ritagliare l'attribuzione informazioni. Non puoi utilizzare i loghi di Google in linea (ad esempio, "Queste mappe sono da [Google_logo]").
Mantieni l'attribuzione molto vicina. Se utilizzi screenshot di immagini Google al di fuori di incorporamenti diretti, includono l'attribuzione standard così come appare nell'immagine. Se necessario, puoi personalizzare lo stile e il posizionamento del testo dell'attribuzione, a condizione che sia nelle vicinanze dei contenuti e che siano leggibili per lo spettatore o il lettore medio. Non puoi allontanare l'attribuzione dai contenuti, ad esempio alla fine del libro, i crediti dei tuoi file o programmi o il piè di pagina del tuo sito web.
Includi fornitori di dati di terze parti. Alcuni dati e immagini sulla nostra mappatura che non provengono da Google. Se utilizzi tali immagini, il testo dei tuoi l'attribuzione deve riportare il nome "Google" e i fornitori di dati pertinenti, come "Dati mappa: Google, Maxar Technologies." Quando vengono citati fornitori di dati di terze parti con le immagini, includendo solo "Google" o il logo Google non è un'attribuzione corretta.
Se utilizzi Google Maps Platform su un dispositivo su cui l'attribuzione non è visualizzata pratica, per favore 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 visualizzare le attribuzioni nella tua app.
Recupero delle attribuzioni da un luogo
Se la tua app mostra informazioni ottenute chiamando recupera il luogo per ID, l'app deve mostrare anche attribuzioni di terze parti per i dettagli del luogo ottenuto.
L'API restituisce un
Place
. Per recuperare le attribuzioni dall'oggetto Place
, chiama
Place.getAttributions()
Il metodo restituisce un valore List
di String
oggetti oppure un valore nullo
se non ci sono attribuzioni da mostrare.
String placeId = "INSERT_PLACE_ID_HERE"; List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME); FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields); placesClient.fetchPlace(request).addOnSuccessListener((response) -> { Place place = response.getPlace(); textView.append("Place found: " + place.getName()); List<String> attributions = place.getAttributions(); if (attributions != null) { StringBuilder stringBuilder = new StringBuilder("Attributions: "); for (String attribution : attributions) { stringBuilder.append(attribution).append("\n"); } textView.append(stringBuilder.toString()); }}).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { // Handle the error. } } );
Visualizzare le attribuzioni di una foto
Se nell'app vengono mostrate foto di luoghi, devi:
mostrare le attribuzioni per ogni foto in cui sono presenti.
PhotoMetadata
,
può contenere uno dei due tipi di attribuzioni:
- Attribuzione, una stringa di attribuzione a cui si accede
PhotoMetadata.getAttributions()
- AuthorAttributions, un parametro
AuthorAttributions
a cui accede l'oggettoPhotoMetadata.getAuthorAttributions()
.
Per ottenere le attribuzioni delle stringhe per una foto, richiama
PhotoMetadata.getAttributions()
. Il metodo restituisce un
una sequenza di caratteri HTML o una stringa vuota se non esistono attribuzioni a
display.
// Get the photo metadata from the Place object. PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0); // Get the attribution text. String attributions = photoMetadata.getAttributions();
Per ottenere le attribuzioni dell'autore di una foto, chiama il numero
PhotoMetadata.getAuthorAttributions()
. Il metodo restituisce un
AuthorAttributions
oggetto. Questo oggetto contiene un List
di AuthorAttribution
uno per autore.
// Get the photo metadata from the Place object. PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0); // Get the author attributions object. AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions(); List<AuthorAttribution> authorAttributionList = authorAttributions.asList();
Mostrare una recensione
Un oggetto Place
può contenere fino a cinque recensioni, ciascuna delle quali
è rappresentato da un
Review
. Facoltativamente, puoi mostrare queste recensioni nella tua app.
Quando visualizzi recensioni fornite dagli utenti Google, devi inserire i campi
nome dell'autore nelle vicinanze. Se disponibile nel campo di attribuzione dell'autore
dell'oggetto Review
, ti consigliamo di includere 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 visualizzare l'ordinamento delle recensioni per l'utente finale.
Per accedere alle recensioni, chiama
Place.getReviews()
:
// Specify the fields to return. final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS); // Construct a request object, passing the place ID and fields array. final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields); placesClient.fetchPlace(request).addOnSuccessListener((response) -> { Place place = response.getPlace(); List<Review> reviews = place.getReviews(); // For loop for iterating over the List for (int i = 0; i < reviews.size(); i++) { // For each review, get the Review object. Review placeReview = reviews.get(i); // Get any attribution and author attribution. String reviewAttribution = placeReview.getAttribution(); AuthorAttribution authorAttribution = placeReview.getAuthorAttribution(); // Display the review contents and attributions as necessary. } }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { // Handle the error. } });
Visualizzazione delle attribuzioni di terze parti
Le attribuzioni a fornitori di terze parti contengono contenuti e link in HTML che devi conservare e mostrare all'utente nel formato in cui vengono forniti. Google consiglia di mostrare queste informazioni sotto i dettagli del luogo.
L'API genera attribuzioni per tutti i luoghi utilizzati dall'app. Le attribuzioni vengono fornite per chiamata API, non per località.
Un modo per visualizzare le attribuzioni è utilizzare una
TextView
Ad esempio:
TextView attributionsText = (TextView) findViewById(R.id.attributions); String thirdPartyAttributions = place.getAttributions(); attributionsText.setText(thirdPartyAttributions);
Esempio di attribuzione di terze parti
Listings by <a href="https://www.example.com/">Example Company</a>
Linee guida relative allo stile per l'attribuzione Google
Di seguito sono riportate le linee guida relative allo stile per le attribuzioni di Google in CSS e HTML se non puoi utilizzare il logo Google scaricabile.
Spazio vuoto
La quantità di spazio vuoto intorno al logo completo deve essere uguale o superiore all'altezza della "G" su Google.
Lo spazio tra il testo dell'attribuzione e il logo di Google deve avere la metà della larghezza la "G".
![](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/policies_spacing.png?authuser=5&hl=it)
Leggibilità
La riga dell'autore deve essere sempre chiara, leggibile e nella variante cromatica corretta per un uno specifico contesto. Assicurati sempre di fornire un contrasto sufficiente per la variante del logo che vuoi selezionare.
Colore
Utilizza il testo Google Material Gray 700 su uno sfondo bianco o chiaro con un intervallo compreso tra 0% e 40% massima tinta di nero.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Su sfondi più scuri, sopra la fotografia o i motivi non occupati, usa il testo in bianco per la riga dell'autore e l'attribuzione dei contenuti.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Carattere
Utilizza la Carattere Roboto.
CSS di esempio
Il seguente CSS, quando applicato al testo "Google", eseguirebbe il rendering di "Google" con l'appropriata carattere, colore e spaziatura 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;