PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation du champ Carte
  • Créer un champ de type Carte
  • Affichage et manipulation des cartes
  • Affichage des cartes
  • Manipulation des cartes par l'utilisateur
  • Spécificités
  • Internet Explorer : Versions nécessaires
  • Modification des permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Présentation du champ Carte
Versions 18 et supérieures
iPhone/iPad Le champ Carte est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
iPhone/iPad Le champ Carte est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Le champ Carte est désormais disponible pour les applications iPhone/iPad.
Versions 20 et supérieures
WINDEVWindows Le champ Carte est désormais disponible pour les applications WINDEV sous Windows.
WEBDEV - Code ServeurWindowsLinux Le champ Carte est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Le champ Carte est désormais disponible pour les sites WEBDEV en PHP.
Nouveauté 20
WINDEVWindows Le champ Carte est désormais disponible pour les applications WINDEV sous Windows.
WEBDEV - Code ServeurWindowsLinux Le champ Carte est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Le champ Carte est désormais disponible pour les sites WEBDEV en PHP.
WINDEVWindows Le champ Carte est désormais disponible pour les applications WINDEV sous Windows.
WEBDEV - Code ServeurWindowsLinux Le champ Carte est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Le champ Carte est désormais disponible pour les sites WEBDEV en PHP.
Versions 21 et supérieures
Universal Windows 10 App Le champ Carte est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Le champ Carte est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Le champ Carte est désormais disponible en mode Universal Windows 10 App.
Le champ Carte permet d'afficher une carte afin de se géolocaliser, d'afficher des points d'intérêt (P.O.I), ...
Cette carte provient :
  • Android du service Google Maps pour les applications Android.
    Attention : L'utilisation d'un champ Carte est soumise à des conditions d'utilisation spécifiques. Pour plus de détails, consultez la page d'aide Conditions d'utilisation du champ Carte. Vérifiez la licence Google avant de déployer vos applications.
  • Versions 18 et supérieures
    iPhone/iPad du service Google Maps pour les applications iPhone/iPad sous iOS 5.
    Nouveauté 18
    iPhone/iPad du service Google Maps pour les applications iPhone/iPad sous iOS 5.
    iPhone/iPad du service Google Maps pour les applications iPhone/iPad sous iOS 5.
  • Versions 18 et supérieures
    iPhone/iPad du service géolocalisation de Apple pour les applications iPhone/iPad à partir de iOS 6.
    Nouveauté 18
    iPhone/iPad du service géolocalisation de Apple pour les applications iPhone/iPad à partir de iOS 6.
    iPhone/iPad du service géolocalisation de Apple pour les applications iPhone/iPad à partir de iOS 6.
  • Versions 20 et supérieures
    WINDEVWEBDEV - Code ServeurPHP du service Google Maps pour les sites Web via Google Maps API.
    L'utilisation du champ Carte est soumis à des conditions d'utilisations spécifiques. Selon le mode d'utilisation, il peut être nécessaire d'utiliser une clé Google (fonction CarteLicenceGgl). Vérifiez la licence Google avant de déployer vos applications.
    Nouveauté 20
    WINDEVWEBDEV - Code ServeurPHP du service Google Maps pour les sites Web via Google Maps API.
    L'utilisation du champ Carte est soumis à des conditions d'utilisations spécifiques. Selon le mode d'utilisation, il peut être nécessaire d'utiliser une clé Google (fonction CarteLicenceGgl). Vérifiez la licence Google avant de déployer vos applications.
    WINDEVWEBDEV - Code ServeurPHP du service Google Maps pour les sites Web via Google Maps API.
    L'utilisation du champ Carte est soumis à des conditions d'utilisations spécifiques. Selon le mode d'utilisation, il peut être nécessaire d'utiliser une clé Google (fonction CarteLicenceGgl). Vérifiez la licence Google avant de déployer vos applications.
  • Versions 21 et supérieures
    Universal Windows 10 App du service Bing Map pour les applications en mode Universal Windows 10 App.
    Attention :
    • L'utilisation du champ Carte est soumis à des conditions d'utilisations spécifiques. Il est nécessaire d'utiliser une clé Bing (fonction CarteLicenceBing). Vérifiez la licence Bing avant de déployer vos applications.
    • Le positionnement via une chaîne de caractères peut donner des résultats incohérents. Il est conseillé d'utiliser plutôt un positionnement via une variable de type Adresse ou de type géoPosition.
    Nouveauté 21
    Universal Windows 10 App du service Bing Map pour les applications en mode Universal Windows 10 App.
    Attention :
    • L'utilisation du champ Carte est soumis à des conditions d'utilisations spécifiques. Il est nécessaire d'utiliser une clé Bing (fonction CarteLicenceBing). Vérifiez la licence Bing avant de déployer vos applications.
    • Le positionnement via une chaîne de caractères peut donner des résultats incohérents. Il est conseillé d'utiliser plutôt un positionnement via une variable de type Adresse ou de type géoPosition.
    Universal Windows 10 App du service Bing Map pour les applications en mode Universal Windows 10 App.
    Attention :
    • L'utilisation du champ Carte est soumis à des conditions d'utilisations spécifiques. Il est nécessaire d'utiliser une clé Bing (fonction CarteLicenceBing). Vérifiez la licence Bing avant de déployer vos applications.
    • Le positionnement via une chaîne de caractères peut donner des résultats incohérents. Il est conseillé d'utiliser plutôt un positionnement via une variable de type Adresse ou de type géoPosition.
WINDEVWEBDEV - Code ServeurAndroidPHP Attention : Evolutions de la licence Google
A partir du 22 Juin 2016, les conditions d'utilisation des services de cartographie de Google ont évolué. Il est désormais obligatoire de spécifier une clé de licence pour utiliser ce service. Vous devez :
  1. Générer la clé dans la console développeur de Google (https://console.developers.google.com). Les manipulations à réaliser sont les suivantes (à la date d'écriture de cette page) :
    • Utilisez un compte Google pour se connecter à la console développeur.
    • Créez un projet si nécessaire.
    • Accédez au "Gestionnaire d'API" du projet.
    • Dans la rubrique "API Google Maps", cliquez sur le lien "Google Maps JavaScript API".
    • Cliquez sur "Activer" afin d'activer l'API Google Maps Javascript API.
    • Dans la rubrique "Identifiants", déroulez le bouton "Créer des identifiants".
    • Sélectionnez "Clé d'API".
      • Dans le cas d'un site WEBDEV, sélectionnez "Clé navigateur". Il est recommandé de préciser le domaine qui utilisera la clé pour le suivi des requêtes et pour éviter toute usurpation.
      • Dans le cas d'une application WINDEV, sélectionnez "Clé serveur". Il est recommandé de préciser l'adresse qui utilisera la clé pour le suivi des requêtes et pour éviter toute usurpation.
    • Validez la création de la clé, puis copiez la clé créée par Google.
  2. Indiquez la clé utilisée dans l'application ou le site grâce à la fonction CarteLicenceGgl.
A partir du 11 Juin 2018, les conditions d'utilisation des services de cartographie de Google ont évolué. La clé de licence pour utiliser ce service est désormais payante.
La carte affichée est interactive : il est possible de zoomer, de se déplacer, ... Elle peut être affichée sous forme graphique ou sous forme de vue satellitaire.

Créer un champ de type Carte

Pour créer un champ de type Carte :
  1. Sous l'éditeur de fenêtres, cliquez sur l'icône (ou sélectionnez l'option "Insertion .. Champ .. Champ Carte").Sous le volet "Création", dans le groupe "Champs graphiques", cliquez sur "Carte".
  2. Cliquez dans la fenêtre ou la page à la position où le champ doit être créé.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ. L'onglet "Général" permet de définir les principales options du champ :
  • le mode d'affichage : plan ou satellite,
  • WINDEVWEBDEV - Code ServeurAndroidUniversal Windows 10 AppPHP l'affichage ou non des boutons de zoom dans le champ,
  • AndroidUniversal Windows 10 App la mise à l'échelle par double tap,
  • WINDEV la mise à l'échelle par double clic,
  • WINDEVAndroidiPhone/iPadUniversal Windows 10 App la mémorisation de la dernière position affichée.
  • l'image utilisée pour les marqueurs des points d'intérêt (P.O.I.).
    Android Ces marqueurs peuvent être affichés avec une ombre ou non.
Remarques :
  • AndroidiPhone/iPad Un seul champ Carte peut être utilisé dans une fenêtre ou une page. Il n'est pas possible d'utiliser plusieurs champs Carte dans la même fenêtre ou page.
  • WINDEV Le champ Carte n'est pas manipulable par les tests automatiques.
  • AndroidiPhone/iPad La fonction géoLanceAppli permet de lancer l'application de cartographie native de l'appareil.
Affichage et manipulation des cartes

Affichage des cartes

A l'ouverture de la fenêtre contenant un champ Carte, une carte du monde est automatiquement affichée : la carte est centrée sur l'équateur avec un niveau de zoom minimal. A l'ouverture de la fenêtre contenant un champ Carte, une carte du monde est automatiquement affichée : la carte est centrée sur l'Europe avec un niveau de zoom moyen.
WINDEVAndroidiPhone/iPadUniversal Windows 10 App Il est possible d'afficher la dernière position mémorisée : il suffit de sélectionner l'option "Mémoriser la dernière position affichée" dans l'onglet "Général" de la fenêtre de description du champ Carte. Dans ce cas, la dernière position est affichée avec le même niveau de zoom.

Manipulation des cartes par l'utilisateur

L'utilisateur peut se déplacer dans la carte :
  • AndroidiPhone/iPadUniversal Windows 10 App en la faisant défiler avec un ou plusieurs doigts.
  • WINDEVWEBDEV - Code ServeurPHP en la faisant défiler à l'aide de la souris.
  • WINDEVWEBDEV - Code ServeurAndroidUniversal Windows 10 AppPHP via les boutons de positionnement du champ (si l'option "Afficher les boutons de zoom" a été sélectionnée dans l'onglet "Général" de la fenêtre de description du champ).
Le zoom utilisé pour l'affichage peut être modifié :
  • AndroidiPhone/iPadUniversal Windows 10 App en effectuant un geste de type "scale" (ou "pinch") : un écartement de deux doigts sur l'écran permet de zoomer et un rapprochement de deux doigts sur l'écran permet de dé-zoomer.
  • WINDEVWEBDEV - Code ServeurAndroidUniversal Windows 10 AppPHP en utilisant les boutons de zoom du champ (si l'option a été sélectionnée dans l'onglet "Général" de la fenêtre de description du champ).
  • AndroidUniversal Windows 10 App en effectuant un "double tap" sur la carte pour zoomer d'un niveau sur une position (si l'option a été sélectionnée dans l'onglet "Général" de la fenêtre de description du champ).
  • WINDEV en effectuant un double-clic sur la carte pour zoomer d'un niveau sur une position (si l'option a été sélectionnée dans l'onglet "Général" de la fenêtre de description du champ).
  • par programmation avec la propriété ..Zoom.
AndroidiPhone/iPad Remarque : Des traitements optionnels spécifiques au champ Carte peuvent également être utilisés. Pour plus de détails, consultez Traitements associés au champ Carte.
WINDEVWEBDEV - Code ServeurPHP Pour connaître toutes les manipulations disponibles en exécution, consultez Champ Carte : Fonctionnalités Automatiques de vos Applications (FAA).
Spécificités
WINDEVWEBDEV - Code Serveur

Internet Explorer : Versions nécessaires

WINDEV Dans une application WINDEV, le champ Carte utilise ActiveX de Internet Explorer sur le poste du client. Pour utiliser le champ Carte dans l'application, l'utilisateur final doit avoir Internet Explorer 10 ou 11 installé sur son poste.
WEBDEV - Code Serveur Pour visualiser un champ Carte dans un site WEBDEV, l'internaute doit utiliser :
  • Internet Explorer 10 ou 11.
  • Un autre navigateur (Chrome, Firefox, ...).
Android

Modification des permissions

L'utilisation d'un champ Carte entraîne l'ajout automatique de la permission INTERNET à la liste des permissions requises par l'application.
Liste des exemples associés :
Le champ Carte Exemples unitaires (WEBDEV) : Le champ Carte
[ + ] Utilisation du champ Carte de WEBDEV.
Il permet d'afficher une carte comprenant des marqueurs et également d'afficher un itinéraire.
Le champ Carte Exemples unitaires (WINDEV) : Le champ Carte
[ + ] Utilisation du champ Carte de WINDEV.
Il permet d'afficher une carte comprenant des marqueurs et également d'afficher un itinéraire.
La fonction gglRécupèreCarte Exemples unitaires (WINDEV) : La fonction gglRécupèreCarte
[ + ] Utilisation de la fonction gglRécupèreCarte pour afficher une carte Google dans un champ Image.
WM Geolocalisation Exemples multiplateforme (WINDEV Mobile) : WM Geolocalisation
[ + ] Cet exemple présente comment gérer des recherches de proximité avec géolocalisation :
- recherche autour de moi
- recherche dans une ville, à une adresse donnée, proche d'une adresse.
Les résultats apparaissent dans une zone répétée et dans une carte avec des marqueurs.
WM Sports Exemples multiplateforme (WINDEV Mobile) : WM Sports
[ + ] Cet exemple est une application de sport vous permettant d'enregistrer vos performances.
L'application calcule la distance parcourue, le temps, la vitesse moyenne et le nombre de calories dépensées en fonction du sport pratiqué.
Le parcours réalisé est affiché sur un champ carte grâce à des marqueurs et un tracé d'itinéraire.

L'exemple dispose aussi d'une partie serveur qui sert à la synchronisation des données des utilisateurs.
Ce webservice est disponible dans l'exemple WEBDEV "WW_Sports".
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire