Ce document liste les exigences spécifiques à toutes les applications développées avec le SDK Places pour iOS, y compris le service Place Autocomplete inclus dans cette API. Des informations plus générales destinées aux développeurs Google Maps sont disponibles dans les Conditions d'utilisation de Google Maps Platform.
Mentionner les conditions d'utilisation et règles de confidentialité
Si vous développez une application utilisant le SDK Places pour iOS, vous devez mettre à disposition les Conditions d'utilisation et des Règles de confidentialité avec votre application conformément aux consignes décrites dans votre contrat avec Google:
- Les conditions d'utilisation et les règles de confidentialité doivent être publiques.
- Vous devez stipuler explicitement dans les conditions d'utilisation qu'en utilisant votre application, les utilisateurs sont tenus de respecter les Conditions d'utilisation de Google.
- Dans vos règles de confidentialité, vous devez informer les utilisateurs que vous avez recours aux API Google Maps et intégrer les Règles de confidentialité de Google pour référence.
L'emplacement recommandé pour insérer vos conditions d'utilisation et règles de confidentialité dépend de la plate-forme de votre application.
Applications mobiles
Si vous développez une application mobile, nous vous recommandons de fournir un lien vers les conditions d'utilisation et règles de confidentialité sur la page de téléchargement de votre application (sur la plate-forme concernée) et dans le menu des paramètres de l'application.
Applications Web
Si vous développez une application Web, nous vous recommandons de fournir un lien vers les conditions d'utilisation et les règles de confidentialité dans le pied de page de votre site Web.
Préchargement, mise en cache ou stockage de contenu
Les applications qui utilisent le SDK Places pour iOS sont liées par les conditions de votre contrat avec Google. Conformément aux dispositions de votre contrat, vous ne devez précharger, indexer, stocker ni mettre en cache aucun contenu, sauf conformément aux conditions limitées énoncées dans les dispositions.
Notez que l'ID de lieu, qui permet d'identifier un lieu de façon unique, n'est pas soumis aux restrictions de mise en cache. L'ID de lieu est renvoyé dans le champ place_id des réponses du SDK Places pour iOS. Découvrez comment enregistrer, actualiser et gérer les ID de lieu dans le guide des ID de lieu.
Afficher les résultats du SDK Places pour iOS
Vous pouvez afficher les résultats du SDK Places pour iOS sur une carte Google ou sans carte. Si vous souhaitez afficher les résultats du SDK Places pour iOS sur une carte, il doit s'agir d'une carte Google. Il est interdit d'utiliser les données du SDK Places pour iOS sur une carte autre que Google.
Affichage des attributions et du logo Google
Si votre application affiche des données sur une carte Google, vous devez inclure le logo Google sans le modifier. Les applications qui affichent des données Google sur le même écran qu'une carte Google ne sont pas tenues de fournir d'autres informations d'attribution à Google.
Si votre application affiche des données sur une page ou une vue sans carte Google, vous devez accompagner ces données du logo Google. Par exemple, si votre application affiche des données Google dans un onglet et une carte Google avec ces données dans un autre onglet, le premier onglet doit afficher le logo Google. Si votre application utilise des champs de recherche avec ou sans saisie semi-automatique, le logo doit être visible sur la même ligne ou juste à côté.
Le logo Google doit être positionné en bas à gauche de la carte et les informations d'attribution doivent être placées en bas à droite. Ces deux éléments doivent s'afficher entièrement sur la carte, et non en dessous de la carte ni à un autre endroit dans l'application. L'exemple de carte suivant montre le logo Google en bas à gauche de la carte et l'attribution en bas à droite.
| À utiliser sur un arrière-plan clair | À utiliser sur un arrière-plan sombre |
|---|---|
|
|
Le fichier zip suivant contient le logo Google dans les dimensions appropriées pour les applications de bureau, Android et iOS. Vous ne devez en aucun cas redimensionner ni modifier ces logos.
Télécharger : google_logo.zip
Ne modifiez pas l'attribution. Vous ne devez pas supprimer, masquer ni rogner les informations d'attribution. Vous ne pouvez pas utiliser les logos Google en les intégrant (par exemple, "Ces cartes proviennent de [Google_logo]").
Placez les informations d'attribution à proximité du contenu. Si vous utilisez des captures d'écran d'images Google en dehors d'intégrations directes, incluez l'attribution standard telle qu'elle apparaît dans l'image. Si nécessaire, vous pouvez personnaliser le style et l'emplacement du texte d'attribution à condition qu'il soit placé à proximité du contenu et lisible par un utilisateur lambda. Vous n'êtes pas autorisé à déplacer l'attribution en dehors du contenu, par exemple à la fin de votre livre, dans les crédits de vos fichiers ou de votre émission, ou dans le pied de page de votre site Web.
Indiquez les fournisseurs de données tiers. Dans nos produits de cartographie, certaines données et images proviennent de fournisseurs autres que Google. Si vous utilisez de telles images, le texte de votre attribution doit mentionner le nom "Google" et les fournisseurs de données concernés (par exemple, "Données cartographiques : Google, Maxar Technologies"). Lorsque des fournisseurs de données tiers sont cités avec les images, la seule mention de "Google" ou du logo Google ne constitue pas une information d'attribution suffisante.
Si vous utilisez Google Maps Platform sur un appareil où il n'est pas pratique d'afficher les informations d'attribution, veuillez contacter l'équipe commerciale Google pour discuter des licences adaptées à votre situation.
Autres exigences concernant l'attribution
Les attributions à des fournisseurs tiers contiennent du contenu et des liens que vous devez présenter à l'utilisateur dans le format dans lequel ils sont fournis. Google recommande que votre application affiche ces informations sous les informations sur le lieu.
Les attributions tierces renvoyées par l'API n'incluent pas l'attribution Google. Vous devez inclure cette attribution vous-même, comme décrit dans la section Affichage des attributions et du logo Google.
Suivez ces instructions pour récupérer des attributions tierces pour un seul lieu ou un ensemble de lieux.
Récupérer les attributions pour un seul lieu
Lorsque vous récupérez un lieu en l'obtenant par ID, vous pouvez récupérer les attributions de ce lieu à partir de la propriété attributions sur GMSPlace.
Les attributions sont fournis en tant qu'objet NSAttributedString.
Récupérer les attributions pour une collection de lieux
Si votre application affiche des informations obtenues en demandant le lieu actuel de l'appareil, elle doit afficher les mentions tierces pour les détails du lieu affichés. Vous pouvez récupérer les attributions de tous les lieux récupérés dans la requête, à partir de la propriété attributions sur
GMSPlaceLikelihoodList.
Les attributions sont fournis en tant qu'objet NSAttributedString, auquel vous pouvez accéder et afficher de la même manière que les attributions dans un seul emplacement, comme décrit ci-dessus.
Attributions des résultats de recherche
En Europe, lorsque vous utilisez le classement standard de Google, les produits de recherche ne doivent pas comporter plus d'un clic de texte explicatif décrivant les principaux facteurs et la pondération de ceux qui déterminent le classement des résultats de recherche. Texte explicatif:
En-tête:À propos de ces résultats
Corps:Lorsque vous recherchez des établissements ou des lieux à proximité d'un emplacement, Google Maps affiche les résultats à proximité. Plusieurs facteurs (essentiellement la pertinence, la distance et la proéminence) sont combinés afin de trouver les meilleurs résultats pour votre recherche.
Bouton 1 : En savoir plus
Le texte "En savoir plus" doit rediriger vers un article du centre d'aide.
Bouton 2:OK
Afficher les attributions pour une photo
Si votre application affiche des photos, vous devez afficher tous les attributions et authorAttributions pour chaque photo qui en contient.
- Pour accéder à des attributions, utilisez
GMSPlacePhotoMetadata.attributions. Cette propriété est uneNSAttributedStringounils'il n'y a aucune attribution à afficher. - Pour accéder aux attributions d'auteur, utilisez
GMSPlacePhotoMetadata.authorAttributions. Cette propriété contient un tableau d'objetsGMSPlaceAuthorAttribution.
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; } } }];
Afficher un avis
Un objet GMSPlace peut contenir jusqu'à cinq avis, chacun étant représenté par un objet GMSPlaceReview. Si vous le souhaitez, vous pouvez afficher ces avis dans votre application.
Lorsque vous affichez des avis provenant d'utilisateurs de Google, vous devez insérer le nom de l'auteur à proximité immédiate. Nous vous recommandons d'inclure également la photo de l'auteur et le lien vers son profil s'ils sont disponibles dans le champ de l'objet GMSPlaceReview contenant les informations sur l'auteur. L'image suivante montre un exemple d'avis sur un parc:
Google vous recommande également d'indiquer à l'utilisateur final comment les avis sont triés.
Pour accéder aux avis:
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. } }];
Afficher les attributions tierces
Les attributions à des fournisseurs tiers sont fournies sous la forme d'objets NSAttributedString contenant du contenu et des liens que vous devez conserver et afficher à l'utilisateur.
La méthode recommandée pour afficher les attributions consiste à utiliser un UITextView, car les liens des attributions doivent fonctionner.
Pour vous assurer que les liens fonctionnent, définissez un délégué sur UITextView et définissez la méthode shouldInteractWithURL de votre UITextViewDelegate pour renvoyer 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; }
Exemple de mention tierce
Une mention tierce est généralement représentée sous la forme d'un texte avec un lien. Exemple :
Annonces de Exemple d'entreprise
Dans l'exemple ci-dessus, la plage de texte Example Company est couverte par un attribut NSLink.
Consignes de style pour l'attribution Google
Vous trouverez ci-dessous les consignes à appliquer concernant le style des attributions Google en CSS et HTML si vous ne pouvez pas utiliser le logo Google téléchargeable.
Espacement
L'espacement autour du logo complet doit être égal ou supérieur à la hauteur du "G" de Google.
L'espacement entre le texte d'attribution et le logo Google doit correspondre à la moitié de la largeur du "G".
Lisibilité
Le nom de l'auteur doit toujours s'afficher de façon claire et lisible, dans une variante de couleur adaptée à l'arrière-plan. Veillez à toujours prévoir suffisamment de contraste pour la variante de logo que vous choisissez.
Couleur
Utilisez un texte en Google Material Gray 700 sur un arrière-plan clair ou blanc, avec une teinte de noir entre 0 % et 40 % maximum.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
Sur les arrière-plans plus sombres, et sur les photos ou motifs simples, utilisez un texte blanc pour le nom de l'auteur et l'attribution.
#FFFFFF RGB 255 255 255 HSL 0 0 100 HSB 0 0 100
Police
Utilisez la police Roboto.
Exemple d'élément CSS
L'élément CSS suivant appliqué au texte "Google" affichera "Google" avec les paramètres appropriés (police, couleur et espacement) sur un arrière-plan clair ou blanc.
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;