Norme relative all'SDK Places per Android

Questo argomento fornisce i requisiti di attribuzione per tutte le applicazioni sviluppate con l'SDK Places per Android, 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 Places SDK for Android, devi rendere disponibili i Termini di utilizzo e le Norme sulla privacy con la tua applicazione, che devono rispettare 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'SDK Places per Android sono vincolate dai termini del Contratto con Google. Fatto salvo quanto stabilito nei termini del Contratto, non devi prelevare, indicizzare, memorizzare o memorizzare nella cache alcun Contenuto, salvo nelle limitate condizioni 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'SDK Places per Android. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida sugli ID luogo.

Visualizzazione dei risultati dell'SDK Places per Android

Puoi visualizzare i risultati di Places SDK for Android su una mappa di Google o senza una mappa. Se vuoi visualizzare i risultati di Places SDK for Android su una mappa, questi risultati devono essere visualizzati su una mappa di Google. È vietato utilizzare i dati di Places SDK for Android 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 nella 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 complesso 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.

Nota: le recensioni e le foto fornite tramite l'SDK Places per Android sono soggette alle norme relative ai contenuti e ai prodotti di Google ovunque ti trovi nel mondo. Per segnalare contenuti che tu o i tuoi utenti volete far rimuovere dai servizi di Google ai sensi delle norme di Google o delle leggi vigenti, consulta Segnalare contenuti su Google.

Recuperare le attribuzioni da un luogo

Se la tua app mostra le informazioni ottenute chiamando get place by ID, 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, chiama Place.getAttributions(). Il metodo restituisce un List di oggetti String o null se non sono presenti attribuzioni da visualizzare.

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_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 la tua app mostra foto dei luoghi, devi mostrare le attribuzioni per ogni foto che le contiene. PhotoMetadata, puoi contenere uno dei due tipi di attribuzioni:

• Attributions, una stringa di attribuzione a cui si accede tramite PhotoMetadata.getAttributions().
• AuthorAttributions, un AuthorAttributions oggetto a cui si accede tramite PhotoMetadata.getAuthorAttributions().

Per ottenere le attribuzioni delle stringhe per una foto, chiama PhotoMetadata.getAttributions(). Il metodo restituisce una sequenza di caratteri HTML o una stringa vuota se non sono presenti attribuzioni da visualizzare.

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the attribution text.
String attributions = photoMetadata.getAttributions();

Per visualizzare le attribuzioni dell'autore di una foto, chiama PhotoMetadata.getAuthorAttributions(). Il metodo restituisce un oggetto AuthorAttributions. Questo oggetto contiene un List di oggetti AuthorAttribution, uno per attribuzione dell'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();

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

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 nelle immediate 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 mostrare all'utente finale come vengono ordinate le recensioni.

Nota: per impostazione predefinita, le recensioni vengono ordinate in base alla pertinenza. Per il nuovo SDK, l'ordinamento per pertinenza è l'unica opzione.

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 ai fornitori di terze parti contengono contenuti e link in formato 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 luogo.

Nota: le attribuzioni restituite da questi metodi non includono l'attribuzione Google. Devi includere personalmente questo riconoscimento, come descritto nella sezione Visualizzare il logo e i riconoscimenti di Google.

Un modo per visualizzare le attribuzioni è con un 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 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 un intervallo di 0-40% di tinta massima di nero.

Google

#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.

Google

#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;