Norme relative all'SDK Places per iOS

Questo documento elenca i requisiti specifici di tutte le applicazioni sviluppato con l'SDK Places per iOS, incluso Place Autocomplete che fa parte di quell'API. Ulteriori informazioni generali su Google Maps per gli sviluppatori sono disponibili nel Termini di servizio di Google Maps Platform.

Fornendo Termini e condizioni d'uso e norme sulla privacy

Se sviluppi un'applicazione Places SDK for iOS, 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 iOS 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 iOS. Scopri come salvare, aggiornare e gestire gli ID luogo nella guida agli ID luogo.

Visualizzazione dei risultati di Places SDK for iOS

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

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

Le attribuzioni a fornitori di terze parti includono contenuti e link che puoi devono essere mostrati all'utente nel formato in cui sono forniti. Google consiglia di mostrare queste informazioni sotto i dettagli del luogo nell'app.

Le attribuzioni di terze parti restituite L'API non include l'attribuzione di Google. Devi non includere questa attribuzione personalmente, come descritto in Visualizzazione del logo e delle attribuzioni di Google.

Suggerimento: potrebbe essere utile usare una libreria di terze parti per eseguire il rendering dei dati di NSAttributedString.

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

Recuperare le attribuzioni per un singolo luogo

Quando recuperi un luogo ricevendo una luogo per ID, può recuperare le attribuzioni per tale luogo dal Proprietà attributions attiva GMSPlace.

Gli attributions vengono forniti come Oggetto NSAttributedString.

Recuperare le attribuzioni per una raccolta di luoghi

Se la tua app mostra informazioni ottenute richiedendo l'accesso luogo corrente, l'app deve mostrare attribuzioni di terze parti per i dettagli del luogo visualizzati. Puoi recuperare attribuzioni per tutti i luoghi recuperati nella richiesta, attributions proprietà attiva GMSPlaceLikelihoodList.

Gli attributions vengono forniti come Oggetto NSAttributedString, a cui puoi accedere e che puoi visualizzare come attributions in un unico luogo, come descritto qui sopra.

Visualizzare le attribuzioni di una foto

Se l'app viene visualizzata foto, devi mostra eventuali attributions e authorAttributions per ciascuno foto che le contiene.

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

Swift

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
    }
  }
}
    

Objective-C

[[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;
          }
        }
      }];
    

Mostrare una recensione

Un oggetto GMSPlace può contenere fino a cinque recensioni, ciascuna delle quali La recensione è rappresentata da un oggetto GMSPlaceReview. Puoi puoi visualizzare 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 GMSPlaceReview, ti consigliamo di includere foto e link al suo profilo. L'immagine seguente mostra un esempio di una recensione di un parco:

Google consiglia inoltre di visualizzare l'ordinamento delle recensioni per l'utente finale.

Nota: l'impostazione predefinita è ordinare le recensioni per pertinenza. Per il nuovo SDK, l'ordinamento per pertinenza è l'unica opzione.

Per accedere alle recensioni:

Swift

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

  }
})

Objective-C

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

  }
}];

Mostra attribuzioni di terze parti

Le attribuzioni a fornitori di terze parti vengono fornite come oggetti NSAttributedString che includere contenuti e link che devono essere conservati e mostrati all'utente.

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

Swift

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

// MARK: - UITextViewDelegate

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

Objective-C

...
  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 consiste in testo con un link. Per esempio:

Schede dell'azienda di esempio

Nell'esempio precedente, l'intervallo di testo Azienda di esempio è coperto dai un attributo NSLink.

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

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.

Google

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

Google

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