Norme e attribuzioni per Places SDK for iOS

Questo documento elenca i requisiti specifici per tutte le applicazioni sviluppate con Places SDK for iOS, 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.

Norme

Questa sezione descrive le norme pertinenti a Places SDK for iOS. Le norme forniscono linee guida e requisiti pratici per l'implementazione che ti aiutano a utilizzare il servizio correttamente e in linea con le aspettative di Google Maps Platform.

Eccezioni alle restrizioni relative alla memorizzazione nella cache

Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è esente dalle restrizioni relative alla memorizzazione nella cache. Pertanto, puoi archiviare 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 ID luogo.

Paesi e regioni dello Spazio economico europeo

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

• Termini di servizio di Google Maps Platform per il SEE
• Termini specifici di servizio di Google Maps Platform per il SEE
• Domande frequenti 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 di servizio di Google Maps Platform

Requisiti di attribuzione di Google Maps

Questa sezione fornisce i requisiti e le 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.

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 modificare, 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'ombra o uno spazio vuoto sufficiente.
• Quando apporti modifiche visive, devi rispettare tutti i requisiti di attribuzione di Google Maps.

Attribuzione di testo e logo di Google Maps

L'attribuzione deve assumere la forma del logo di Google Maps, se possibile. Nei casi in cui lo spazio è limitato, il testo Google Maps è accettabile. Gli utenti finali devono sempre sapere chiaramente quali contenuti sono forniti da Google Maps.

Attribuzione del logo

Scaricare i loghi di Google Maps

Utilizza i file del logo ufficiale di Google Maps. Scarica i loghi di seguito e segui le linee guida riportate in questa sezione.

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 con contorno su uno sfondo occupato, ad esempio una mappa o un'immagine.
• Utilizza il logo senza contorno su uno sfondo semplice, ad esempio un colore uniforme o una sfumatura leggera.

Specifiche delle dimensioni del logo

• 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ù sui dp, consulta Densità di pixel sul sito web di Material Design.

Accessibilità del logo

• Mantieni un contrasto accessibile tra il logo e lo sfondo.
• Includi un'etichetta di accessibilità con il testo 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:

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

• Applica lo stile al testo di Google Maps come descritto nella tabella seguente:

  Requisiti di stile 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 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). Mantieni un contrasto accessibile (4,5:1) rispetto allo sfondo.
  Dimensione carattere	Dimensione carattere minima: 12 sp Dimensione carattere massima: 16 sp Per scoprire di più sugli sp, consulta Unità di dimensione carattere sul sito web di Material Design.
  Spaziatura tra le lettere	Normale

Esempio di CSS

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

• Posiziona l'attribuzione nella 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'ombra o uno spazio vuoto sufficiente.

• Non travisare Google Maps attribuendolo a contenuti non di Google Maps Platform.
• Verifica che l'attribuzione sia sempre visibile e leggibile. Non rimuoverla, nasconderla, oscurarla o modificarla mai.

Le seguenti immagini mostrano esempi di questi requisiti visivi.

Fornitori di dati di terze parti

Alcuni dati e 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 della tua attribuzione deve indicare il nome "Google Maps" e i fornitori di dati pertinenti, ad esempio "Dati mappa: Google, Maxar Technologies." Quando Google fornisce l'attribuzione di terze parti, l'inclusione di solo "Google Maps" o del logo Google non è un'attribuzione corretta.

Altri requisiti di attribuzione

Le attribuzioni a fornitori di terze parti contengono contenuti e link che devi mostrare all'utente nel formato in cui vengono forniti. Google consiglia di mostrare queste informazioni sotto i dettagli del luogo.

Le attribuzioni di terze parti restituite dall'API non includono l'attribuzione di Google. Devi includere questa attribuzione autonomamente, come descritto in Visualizzare il logo e le attribuzioni di Google.

Segui queste istruzioni per recuperare le attribuzioni di terze parti per un singolo luogo o una raccolta di luoghi.

Recuperare le attribuzioni per un singolo luogo

Quando recuperi un luogo ottenendolo tramite ID, puoi recuperare le attribuzioni per quel luogo dalla attributions proprietà su GMSPlace.

Le attributions vengono fornite come un NSAttributedString oggetto.

Recuperare le attribuzioni per una raccolta di luoghi

Se la tua app mostra informazioni ottenute richiedendo il luogo attuale del dispositivo, deve mostrare le attribuzioni di terze parti per i dettagli del luogo visualizzati. Puoi recuperare le attribuzioni per tutti i luoghi recuperati nella richiesta, dalla attributions proprietà su GMSPlaceLikelihoodList.

Le attributions vengono fornite come oggetto NSAttributedString a cui puoi accedere e visualizzare nello stesso modo delle attributions di un singolo luogo, come descritto sopra.

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 vicino a una località, Google Maps ti mostrerà i risultati locali. Per trovare i risultati migliori per la ricerca, vengono combinati diversi fattori, principalmente pertinenza, distanza ed evidenza.

Pulsante 1: Scopri di più
"Scopri di più" testo deve rimandare a un articolo del Centro assistenza.

Pulsante 2: OK

Visualizzare le attribuzioni per una foto

Se la tua app mostra foto, devi mostrare tutte le attributions e le authorAttributions per ogni foto che le contiene.

• Per accedere a eventuali attribuzioni, utilizza GMSPlacePhotoMetadata.attributions. Questa proprietà è un NSAttributedString o nil se non ci sono attribuzioni da visualizzare.
• Per accedere a eventuali attribuzioni dell'autore, utilizza GMSPlacePhotoMetadata.authorAttributions. Questa proprietà contiene un array di GMSPlaceAuthorAttribution oggetti.

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}
    

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
      callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                  NSError *_Nullable error) {
        if (error) {
          // TODO: handle the error.
          NSLog(@"Error: %@", [error description]);
        } else {
          // Get attribution for the first photo in the list.
          if (photos.results.count > 0) {
            GMSPlacePhotoMetadata *photo = photos.results.firstObject;
            NSAttributedString *attributions = photo.attributions;
          }
        }
      }];
    

Visualizzare una recensione

Un oggetto GMSPlace può contenere fino a cinque recensioni, dove ogni recensione è rappresentata da un oggetto GMSPlaceReview. Puoi anche visualizzare queste recensioni nella tua app.

Quando visualizzi le recensioni inviate dagli utenti Google, devi posizionare il nome dell'autore nelle vicinanze. Quando è disponibile nel campo di attribuzione dell'autore dell'oggetto GMSPlaceReview, 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.

Per accedere alle recensioni:

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

Visualizzare le attribuzioni di terze parti

Le attribuzioni a fornitori di terze parti vengono fornite come NSAttributedString oggetti che contengono contenuti e link che devi conservare e mostrare all'utente.

Il modo consigliato per visualizzare le attribuzioni è con un UITextView, perché i link nelle attribuzioni devono funzionare. Per assicurarti che i link funzionino, imposta un delegato su UITextView e imposta il metodo shouldInteractWithURL di UITextViewDelegate in modo che restituisca YES.

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}
    

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}
    

Esempio di attribuzione di terze parti

Un'attribuzione di terze parti in genere è costituita da testo con un link. Ad esempio:

Annunci di Example Company

Nell'esempio precedente, l'intervallo di testo Example Company è coperto da un NSLink attributo.

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 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 è quindi soggetto alle restrizioni sui contenuti di Google Maps nel tuo contratto Google Maps Platform. Questa eccezione si applica solo all'indirizzo stradale selezionato dall'utente finale e solo per la transazione specifica dell'utente finale; non si applica all'elenco di indirizzi suggeriti forniti 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 restrizioni sui contenuti di Google Maps. Una volta che l'utente finale seleziona l'indirizzo scelto, questo indirizzo non è soggetto alle restrizioni sui contenuti di Google Maps solo ai fini della transazione applicabile dell'utente finale.