In questo documento sono elencati i requisiti specifici per tutte le applicazioni sviluppate con Places SDK for iOS, incluso il servizio Place Autocomplete, che fa parte dell'API. Ulteriori informazioni generali per gli sviluppatori di Google Maps sono disponibili nei Termini di servizio di Google Maps Platform.
Fornire i Termini e condizioni d'uso e le norme sulla privacy
Se sviluppi un'applicazione Places SDK for iOS, devi rendere disponibili i Termini d'uso e le Norme sulla privacy della tua applicazione, che soddisfano le linee guida descritte nel Contratto con Google:
- I Termini e condizioni d'uso e le Norme sulla privacy devono essere disponibili pubblicamente.
- Devi specificare esplicitamente nei Termini e condizioni d'uso della tua applicazione che, utilizzando la tua applicazione, gli utenti sono vincolati dai Termini di servizio di Google.
- Devi informare gli utenti delle tue Norme sulla privacy che stai utilizzando le API di Google Maps e incorpora queste Norme sulla privacy.
La posizione consigliata per rendere disponibili i tuoi 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 per dispositivi mobili, è consigliabile fornire un link ai Termini e condizioni d'uso e alle Norme sulla privacy nella pagina di download della tua applicazione nell'apposito store e nel menu di impostazioni dell'applicazione.
Applicazioni web
Se stai sviluppando un'applicazione web, ti consigliamo di fornire un link ai Termini e condizioni d'uso e alle Norme sulla privacy nel piè di pagina.
Precaricamento, memorizzazione nella cache o archiviazione dei contenuti
Le applicazioni che utilizzano l'SDK Places per iOS sono vincolate dai termini del Contratto con Google. Soggetto ai termini del Contratto, l'utente non deve precaricare, indicizzare, archiviare o memorizzare nella cache alcun Contenuto se non in base alle condizioni limitate indicate nei termini.
Visualizzazione dell'SDK Places per i risultati iOS
Puoi visualizzare i risultati di Places SDK for iOS su una mappa di Google Maps o senza una mappa. Se vuoi visualizzare l'SDK Places per iOS su una mappa, questi risultati devono essere visualizzati su Google Maps. È vietato utilizzare l'SDK Places per i dati iOS su una mappa diversa da quella di Google.
Visualizzazione del logo e delle attribuzioni di Google
Se la tua applicazione visualizza dati su una mappa Google, il logo Google verrà incluso e non potrà essere modificato. Le applicazioni che mostrano dati Google nella stessa schermata di una mappa Google non devono fornire un'ulteriore attribuzione a Google.
Se la tua applicazione visualizza dati in una pagina o in una visualizzazione che non presenta anche Google Maps, devi mostrare un logo Google con tali dati. Ad esempio, se la tua applicazione visualizza dati Google in una scheda e una mappa Google con questi dati in un'altra scheda, la prima scheda 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 di Google deve essere posizionato nell'angolo in basso a sinistra della mappa, con le informazioni sull'attribuzione posizionate nell'angolo in basso a destra, entrambe visualizzate sulla mappa nel suo complesso e non sotto la mappa o in un altro luogo all'interno dell'applicazione. 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'uso su uno sfondo chiaro | Per l'uso su uno sfondo scuro |
|---|---|
|
|
Il seguente file ZIP contiene il logo di Google nelle dimensioni corrette per applicazioni desktop, 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 Google in linea (ad esempio, "Queste mappe provengono da [Google_logo]").
Non perdere l'attribuzione. Se utilizzi screenshot di immagini Google al di fuori degli incorporamenti diretti, includi l'attribuzione standard così come viene mostrata nell'immagine. Se necessario, puoi personalizzare lo stile e il posizionamento del testo dell'attribuzione, a condizione che il testo sia vicino ai contenuti e leggibile da parte dello spettatore o del lettore medio. Non puoi allontanare l'attribuzione dai contenuti, ad esempio fino alla fine del libro, nei crediti dei file o del programma o nel piè di pagina del tuo sito web.
Includi fornitori di dati di terze parti. Alcuni dati e immagini dei nostri prodotti cartografici provengono da fornitori diversi da Google. Se utilizzi queste immagini, il testo della tua attribuzione deve riportare il nome "Google" e i relativi fornitori di dati, ad esempio "Dati mappa: Google, Maxar Technologies". Quando ci sono fornitori di dati di terze parti citati con le immagini, che includono solo "Google" o il logo di Google non è un'attribuzione appropriata.
Se utilizzi Google Maps Platform su un dispositivo in 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
Le attribuzioni a fornitori di terze parti includono contenuti e link che devi mostrare all'utente nel formato in cui vengono forniti. Google consiglia che l'app mostri queste informazioni sotto i dettagli del luogo.
Le attribuzioni di terze parti restituite dall'API non includono l'attribuzione di Google. Devi includere personalmente questa attribuzione, come descritto nella sezione 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.
Recupero delle attribuzioni per un singolo luogo
Quando recuperi un luogo recuperando un luogo in base all'ID, puoi recuperare le attribuzioni per quel luogo dalla proprietà attributions in
GMSPlace.
attributions viene fornito come un
oggetto NSAttributedString.
Recupero delle attribuzioni per una raccolta di luoghi
Se la tua app visualizza le informazioni ottenute richiedendo il luogo attuale del dispositivo, l'app 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
proprietà attributions su
GMSPlaceLikelihoodList.
attributions viene fornito come
oggetto NSAttributedString, a cui puoi accedere e visualizzare
nello stesso modo di attributions in un unico posto, come descritto
sopra.
Visualizzazione delle attribuzioni per una foto
Se la tua app visualizza foto, devi mostrare le attribuzioni per ogni foto che le contiene. Per ottenere le attribuzioni per una
foto, chiama
GMSPlacePhotoMetadata.attributions. Questa proprietà è una proprietà NSAttributedString o nil se non sono presenti attribuzioni da visualizzare.
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;
}
}
}];
Visualizzazione delle attribuzioni di terze parti
Le attribuzioni a fornitori di terze parti vengono fornite come oggetti NSAttributedString che includono contenuti e link che devi conservare e mostrare all'utente.
Consigliamo di visualizzare le attribuzioni con un UITextView, perché i link nelle attribuzioni devono funzionare.
Per assicurarti che i link funzionino, imposta un delegato in UITextView e imposta il metodo shouldInteractWithURL
di UITextViewDelegate in modo che restituisca 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 costituita da testo con un link. Ad esempio:
Schede di Società di esempio
Nell'esempio precedente, l'intervallo di testo Azienda di esempio è coperto da un attributo NSLink.
Tieni presente che l'ID luogo, utilizzato per identificare in modo univoco un luogo, è
escluso dalla limitazione per la memorizzazione nella cache. Pertanto, puoi memorizzare i valori degli ID luogo in modo indefinito. L'ID luogo viene restituito nel campo place_id nell'SDK Places per le risposte iOS.
Linee guida relative allo stile per l'attribuzione di Google
Di seguito sono riportate le linee guida di stile 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 blocco dovrebbe essere uguale o superiore all'altezza della "G" in Google.
Lo spazio tra il testo sull'attribuzione e il logo di Google dovrebbe essere pari alla metà della larghezza della "G".
Lettura
La riga dell'autore deve essere sempre chiara, leggibile e apparire nella variante di colore corretta per uno sfondo specifico. Assicurati sempre di fornire un contrasto sufficiente per la variante del logo selezionata.
Colore
Utilizza testo Google Material 700 su uno sfondo bianco o chiaro che utilizzi un intervallo compreso tra lo 0% e il 40% di tinta nera.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Su sfondi più scuri e su motivi fotografici o non occupati, utilizza testo bianco per i nomi degli autori e per l'attribuzione.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Carattere
Usa il carattere Roboto.
CSS di esempio
Il seguente CSS, quando applicato al testo "Google", verrebbe visualizzato "Google" con il carattere, il colore e la spaziatura appropriati 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;