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 ulteriori termini di Google Maps Platform, consulta i Termini di servizio di Google Maps Platform.

Norme

Questa sezione descrive le norme pertinenti a Places SDK for Android. Le norme forniscono linee guida e requisiti di implementazione pratici per aiutarti a utilizzare il Servizio correttamente e in linea con le aspettative di Google Maps Platform.

Eccezioni alle limitazioni della memorizzazione nella cache

Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente dalle limitazioni della memorizzazione nella cache. Pertanto, puoi memorizzare i valori dell'ID luogo a tempo indeterminato. L'ID luogo viene restituito nel campo place_id nelle risposte dell'API. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida agli ID luogo.

Paesi e territori dello Spazio economico europeo

Questo prodotto ha Termini di servizio diversi per i clienti con un indirizzo di fatturazione nello Spazio economico europeo (SEE) e potrebbe anche avere funzionalità diverse. Prima di creare con Google Maps Platform, consulta i seguenti termini e informazioni specifici per il SEE:

• Termini di servizio di Google Maps Platform per il SEE
• Termini specifici del servizio per il SEE di Google Maps Platform
• Domande frequenti (FAQ) sul SEE
• Requisiti di sicurezza stradale di Google Maps Platform

Se il tuo indirizzo di fatturazione non si trova nel SEE, si applicano i seguenti Termini di servizio:

• Termini di servizio di Google Maps Platform
• Termini specifici del servizio per Google Maps Platform

Requisiti di attribuzione di Google Maps

Questa sezione fornisce requisiti e linee guida per l'attribuzione per la visualizzazione di Google Maps e dei contenuti tramite le tue applicazioni.

Esempio di attribuzione

Di seguito è riportato un esempio di attribuzione per Places UI Kit.

Attribuzione obbligatoria applicata al componente compatto Place Details. In questa mappa non Google, l'attribuzione di Google Maps è chiaramente visibile e i contenuti di Google Maps Platform sono differenziati visivamente dagli altri contenuti.

Visualizzare l'attribuzione di Google Maps

Quando visualizzi i contenuti delle API Google Maps Platform nella tua app o nel tuo sito web, devi rispettare i requisiti di attribuzione di Google Maps. Non è necessario aggiungere un'attribuzione aggiuntiva se i Contenuti vengono mostrati su una mappa di Google in cui l'attribuzione è già visibile.

Attribuzione di Google Maps inclusa

Per l'attribuzione di Google Maps già fornita da Google Maps Platform nell'interfaccia utente, ad esempio in Places UI Kit:

• Non rimuovere l'attribuzione inclusa, indipendentemente da dove viene visualizzata. Non alterare, nascondere o oscurare l'attribuzione e assicurati che sia chiaramente visibile sullo sfondo.
• Distingui sempre visivamente i contenuti di Google Maps Platform dagli altri contenuti utilizzando indicatori dell'interfaccia utente come un bordo, un colore di sfondo, un'ombreggiatura o uno spazio bianco sufficiente.
• Quando apporti modifiche visive, devi rispettare tutti i requisiti di attribuzione di Google Maps.

Logo di Google Maps e attribuzione del testo

L'attribuzione dovrebbe assumere la forma del logo di Google Maps, se possibile. Nei casi in cui lo spazio è limitato, è accettabile il testo Google Maps. Deve essere sempre chiaro agli utenti finali quali contenuti sono forniti da Google Maps.

A sinistra: attribuzione del logo di Google Maps; a destra: attribuzione del testo di Google Maps

Attribuzione del logo

Segui questi requisiti per utilizzare il logo di Google Maps nella tua app o nel tuo sito web.

Varianti accettabili per l'attribuzione del logo di Google Maps

Scaricare i loghi di Google Maps

Utilizza i file ufficiali del logo di Google Maps. Scarica i loghi riportati di seguito e segui le linee guida di questa sezione.

Scarica gli asset di attribuzione di Google Maps

Quando utilizzi il logo di Google Maps, segui queste linee guida.

• Non modificare il logo in alcun modo.
• Mantieni le proporzioni del logo per evitare distorsioni.
• Utilizza il logo in contorno su uno sfondo elaborato, come una mappa o un'immagine.
• Utilizza il logo non contornato su uno sfondo semplice, ad esempio un colore uniforme o una sfumatura leggera.

Specifiche delle dimensioni del logo

Segui queste specifiche di dimensione per il logo di Google Maps:

• Altezza minima del logo: 16 dp
• Altezza massima del logo: 19 dp
• Spazio vuoto minimo del logo: 10 dp a sinistra, a destra e in alto, 5 dp in basso

Per scoprire di più su dp, consulta la sezione Densità di pixel sul sito web di Material Design.

Logo di Google Maps che mostra lo spazio vuoto minimo e l'intervallo di dimensioni accettabile

Accessibilità del logo

Segui questi requisiti di accessibilità per il logo di Google Maps:

• Mantenere un contrasto accessibile tra il logo e lo sfondo.
• Includi un'etichetta di accessibilità con il testo Google Maps.

Varianti inaccettabili e problemi di accessibilità per l'attribuzione del logo di Google Maps

Attribuzione del testo

Se le dimensioni dell'interfaccia non supportano l'utilizzo del logo di Google Maps, puoi scrivere Google Maps nel testo. Procedi nel seguente modo:

Varianti accettabili dell'attribuzione del testo di Google Maps

• Non modificare in alcun modo il testo Google Maps:
  
  • Non modificare le maiuscole di Google Maps
  • Non mandare a capo Google Maps
  • Non localizzare Google Maps in un'altra lingua.
  • Impedisci ai browser di tradurre Google Maps utilizzando l'attributo HTML translate="no".

Varianti non accettabili dell'attribuzione di testo di Google Maps

• Formatta il testo di Google Maps come descritto nella tabella seguente:

  Requisiti di formattazione del testo di Google Maps
  Proprietà	Stile
  Famiglia di caratteri	Roboto. Il caricamento del carattere è facoltativo.
  Famiglia di caratteri di riserva	Qualsiasi carattere del corpo sans-serif già utilizzato nel tuo prodotto o "Sans-Serif" per richiamare il carattere di sistema predefinito
  Stile carattere	Normale
  Spessore carattere	400
  Colore carattere	Bianco, nero (#1F1F1F) o grigio (#5E5E5E). Mantenere un contrasto accessibile (4,5:1) rispetto allo sfondo.
  Dimensione carattere	Dimensione minima del carattere: 12 sp Dimensione massima del carattere: 16 sp Per saperne di più su sp, consulta Unità di misura delle dimensioni del carattere sul sito web Material Design.
  Spaziatura tra le lettere	Normale

CSS di esempio

Il seguente CSS esegue il rendering di Google Maps con lo stile tipografico e il colore appropriati su uno sfondo bianco o chiaro.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

Requisiti visivi

Segui questi requisiti per il trattamento visivo dell'attribuzione di Google Maps.

• Posiziona l'attribuzione vicino alla parte superiore o inferiore dei contenuti e all'interno dello stesso contenitore visivo. Per una singola riga di contenuti, l'attribuzione può essere posizionata a destra o a sinistra.

• Distingui visivamente i contenuti di Google Maps Platform dagli altri contenuti utilizzando indicatori dell'interfaccia utente come un bordo, un colore di sfondo, un'ombreggiatura o uno spazio bianco sufficiente.

• Non rappresentare in modo ingannevole Google Maps attribuendogli contenuti non di Google Maps Platform.
• Verifica che l'attribuzione sia sempre visibile e leggibile. Non rimuoverlo, nasconderlo, oscurarlo o modificarlo.

Le seguenti figure mostrano esempi di questi requisiti visivi.

Esempio di attribuzione di Google Maps posizionata in alto, in basso e di lato rispetto ai contenuti

Esempio di tre approcci per differenziare i contenuti di Google Maps (la valutazione del luogo) dagli altri contenuti

Non oscurare l'attribuzione di Google Maps né mescolarla con contenuti di altre fonti

Fornitori di dati di terze parti

Alcuni dei dati e delle immagini dei nostri prodotti di mappatura provengono da fornitori diversi da Google. Per alcuni prodotti, come l'API Map Tiles, potremmo fornirti l'attribuzione richiesta al fornitore di dati di terze parti. In questo caso, il testo dell'attribuzione deve riportare il nome "Google Maps" e il nome del fornitore o dei fornitori di dati pertinente/i, ad esempio "Dati delle mappe: Google, Maxar Technologies". Quando Google fornisce l'attribuzione di terze parti, la semplice inclusione di "Google Maps" o del logo Google non è un'attribuzione corretta.

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 Places SDK per Android sono soggette alle norme relative ai contenuti e ai prodotti di Google ovunque ti trovi nel mondo. Per segnalare i contenuti di cui tu o i tuoi utenti volete richiedere la rimozione dai servizi di Google ai sensi delle norme di Google o delle leggi vigenti, consulta Segnalare contenuti su Google.

Recupero delle attribuzioni da un luogo

Se la tua app mostra informazioni ottenute chiamando get place by ID, 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, 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 per una foto

Se la tua app mostra foto di luoghi, devi mostrare le attribuzioni per ogni foto che le ha. PhotoMetadata, può contenere uno dei due tipi di attribuzione:

• Attribuzioni, una stringa di attribuzione a cui si accede tramite PhotoMetadata.getAttributions().
• AuthorAttributions, un oggetto AuthorAttributions 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 oppure una stringa vuota se non ci sono 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 ottenere 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 ogni 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 adulterato di Google, i prodotti di ricerca devono avere un testo esplicativo a non più di un clic di distanza che descriva i fattori principali e la ponderazione dei fattori principali che determinano il ranking dei risultati di ricerca. Testo esplicativo:

Intestazione: Informazioni su questi risultati

Corpo: 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, ognuna delle quali è rappresentata da un oggetto Review. Se vuoi, puoi visualizzare queste recensioni nella tua app.

Quando mostri le recensioni inviate dagli utenti Google, devi posizionare il nome dell'autore nelle immediate vicinanze. Se disponibili 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 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 disponibile.

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 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 questa attribuzione personalmente, come descritto in Visualizzazione del logo e delle attribuzioni 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>

Completamento automatico per gli indirizzi degli utenti finali

Quando un utente finale utilizza la funzionalità di completamento automatico all'interno della tua applicazione cliente per digitare in anticipo un indirizzo stradale e questo indirizzo stradale sarebbe stato fornito in modo completo e accurato dall'utente finale senza il completamento automatico, l'indirizzo selezionato dall'utente finale non è soggetto alle limitazioni dei contenuti di Google Maps nel tuo contratto Google Maps Platform. Questa eccezione si applica solo all'indirizzo civico selezionato dall'utente finale ed esclusivamente per la transazione specifica di quell'utente finale; non si applica all'elenco di indirizzi suggeriti fornito dalla funzionalità di completamento automatico o ad altri contenuti di Google Maps. Questa eccezione non si applica a nessuna funzionalità di ricerca di indirizzi o PDI offerta da altri servizi Google Maps Platform.

Nell'immagine precedente, l'elenco degli indirizzi a sinistra è ancora soggetto alle limitazioni relative ai contenuti di Google Maps. Una volta che l'utente finale seleziona l'indirizzo scelto, quest'ultimo non è soggetto alle limitazioni sui contenuti di Google Maps esclusivamente ai fini della transazione applicabile dell'utente finale.