PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

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
Centre la carte affichée dans un champ Carte sur une position géographique ou un lieu donné. Une animation est automatiquement réalisée.
A la fin de l'animation, l'événement "A chaque changement de position" du champ Carte sera exécuté. Si le positionnement sur la carte est annulé par l’utilisateur avant la fin de l’animation, cet événement ne sera pas exécuté.
Android Attention : Cette fonction est disponible dans l'émulateur Android. Cette fonction n'est pas disponible dans le simulateur Android.
Android Remarque : Cette fonction est disponible dans l'émulateur Android et dans le simulateur Android.
Versions 18 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 18
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 20 et supérieures
WINDEVWindows Cette fonction est désormais disponible pour les applications WINDEV sous Windows.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurWindowsLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Cette fonction est désormais disponible pour les sites PHP.
Nouveauté 20
WINDEVWindows Cette fonction est désormais disponible pour les applications WINDEV sous Windows.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurWindowsLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Cette fonction est désormais disponible pour les sites PHP.
WINDEVWindows Cette fonction est désormais disponible pour les applications WINDEV sous Windows.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurWindowsLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Cette fonction est désormais disponible pour les sites PHP.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
// Centre la carte affichée par le champ "CARTE_Position" sur une position géographique
MaPosition est une géoPosition
CarteAffichePosition(CARTE_Position, MaPosition)
 
// syntaxe équivalente (sans animation) : CARTE_Position = MaPosition
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurAndroidiPhone/iPadUniversal Windows 10 AppPHP
Versions 20 et supérieures
iPhone/iPad Cette syntaxe est disponible à partir de la version 20.
Nouveauté 20
iPhone/iPad Cette syntaxe est disponible à partir de la version 20.
iPhone/iPad Cette syntaxe est disponible à partir de la version 20.
// Centre la carte affichée par le champ "CARTE_Position" sur une ville à partir de son nom
CarteAffichePosition(CARTE_Position, "Montpellier, France")
 
// Centre la carte affichée par le champ "CARTE_Position" sur un monument à partir de son nom
CarteAffichePosition(CARTE_Position, "Tour Eiffel")
Syntaxe
WINDEVAndroidiPhone/iPadUniversal Windows 10 App

Afficher une position géographique Masquer les détails

<Résultat> = CarteAffichePosition(<Champ Carte> , <Position>)
<Résultat> : Booléen
  • Vrai si la carte a pu être positionnée sur la position spécifiée,
  • Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
iPhone/iPadUniversal Windows 10 App <Résultat> est toujours à Vrai, même en cas d'erreur. Il n'est pas possible de savoir si le positionnement a bien été effectué.
<Champ Carte> : Nom de champ
Nom du champ Carte à manipuler. Si ce paramètre correspond à une chaîne vide (""), le champ Carte auquel appartient l'événement en cours sera utilisé.
<Position> : Variable de type géoPosition ou chaîne de caractères
Description du lieu sur lequel sera centrée la carte. Cette description peut correspondre :
  • au nom de la variable de type géoPosition décrivant la position géographique sur laquelle sera centrée la carte.
  • à une chaîne de caractères contenant une adresse, une ville, le nom d'un monument, ...
    Universal Windows 10 App L'usage d'une chaîne de caractères peut entraîner une position incohérente via le service de cartographie de Bing Map.
  • à une variable de type Adresse.
iPhone/iPad Ce paramètre ne peut pas être une chaîne de caractères ou une variable de type Adresse.
Versions 20 et supérieures
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurAndroidiPhone/iPadUniversal Windows 10 AppPHP

Afficher une position géographique avec procédure de vérification Masquer les détails

CarteAffichePosition(<Champ Carte> , <Position> [, <Procédure WLangage>])
<Champ Carte> : Nom de champ
Nom du champ Carte à manipuler. Si ce paramètre correspond à une chaîne vide (""), le champ Carte auquel appartient l'événement en cours sera utilisé.
<Position> : Variable de type géoPosition ou chaîne de caractères
Description du lieu sur lequel sera centrée la carte. Cette description peut correspondre :
  • au nom de la variable de type géoPosition décrivant la position géographique sur laquelle sera centrée la carte.
  • à une chaîne de caractères contenant une adresse, une ville, le nom d'un monument, ...
    Universal Windows 10 App L'usage d'une chaîne de caractères peut entraîner une position incohérente via le service de cartographie de Bing Map.
  • à une variable de type Adresse.
<Procédure WLangage> : Chaîne de caractères optionnelle (avec guillemets)
Nom de la procédure WLangage (également nommée "callback") appelée après l'affichage de la nouvelle position géographique. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Changement effectué>)

où <Changement effectué> est un booléen :
  • Vrai si la position a pu être modifiée,
  • Faux dans le cas contraire.
WEBDEV - Code ServeurPHP Ce paramètre n'est pas disponible.
Nouveauté 20
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurAndroidiPhone/iPadUniversal Windows 10 AppPHP

Afficher une position géographique avec procédure de vérification Masquer les détails

CarteAffichePosition(<Champ Carte> , <Position> [, <Procédure WLangage>])
<Champ Carte> : Nom de champ
Nom du champ Carte à manipuler. Si ce paramètre correspond à une chaîne vide (""), le champ Carte auquel appartient l'événement en cours sera utilisé.
<Position> : Variable de type géoPosition ou chaîne de caractères
Description du lieu sur lequel sera centrée la carte. Cette description peut correspondre :
  • au nom de la variable de type géoPosition décrivant la position géographique sur laquelle sera centrée la carte.
  • à une chaîne de caractères contenant une adresse, une ville, le nom d'un monument, ...
    Universal Windows 10 App L'usage d'une chaîne de caractères peut entraîner une position incohérente via le service de cartographie de Bing Map.
  • à une variable de type Adresse.
<Procédure WLangage> : Chaîne de caractères optionnelle (avec guillemets)
Nom de la procédure WLangage (également nommée "callback") appelée après l'affichage de la nouvelle position géographique. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Changement effectué>)

où <Changement effectué> est un booléen :
  • Vrai si la position a pu être modifiée,
  • Faux dans le cas contraire.
WEBDEV - Code ServeurPHP Ce paramètre n'est pas disponible.
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurAndroidiPhone/iPadUniversal Windows 10 AppPHP

Afficher une position géographique avec procédure de vérification Masquer les détails

CarteAffichePosition(<Champ Carte> , <Position> [, <Procédure WLangage>])
<Champ Carte> : Nom de champ
Nom du champ Carte à manipuler. Si ce paramètre correspond à une chaîne vide (""), le champ Carte auquel appartient l'événement en cours sera utilisé.
<Position> : Variable de type géoPosition ou chaîne de caractères
Description du lieu sur lequel sera centrée la carte. Cette description peut correspondre :
  • au nom de la variable de type géoPosition décrivant la position géographique sur laquelle sera centrée la carte.
  • à une chaîne de caractères contenant une adresse, une ville, le nom d'un monument, ...
    Universal Windows 10 App L'usage d'une chaîne de caractères peut entraîner une position incohérente via le service de cartographie de Bing Map.
  • à une variable de type Adresse.
<Procédure WLangage> : Chaîne de caractères optionnelle (avec guillemets)
Nom de la procédure WLangage (également nommée "callback") appelée après l'affichage de la nouvelle position géographique. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Changement effectué>)

où <Changement effectué> est un booléen :
  • Vrai si la position a pu être modifiée,
  • Faux dans le cas contraire.
WEBDEV - Code ServeurPHP Ce paramètre n'est pas disponible.
Remarques
  • WINDEVAndroidUniversal Windows 10 App La fonction CarteAffichePosition utilise le service de géolocalisation de Google (ou Bing Map pour Universal Windows 10 App). Les positions déterminées à partir de la description d’un lieu dépendent de la quantité et de la précision des informations fournies dans cette description. Si une même description correspond à plusieurs lieux, le service de géolocalisation retournera les correspondances qui lui semble les meilleures.
  • iPhone/iPad Selon la version du mobile ou de la tablette utilisée, le service de cartographie utilisé n'est pas le même :
    • avant iOS 6, le service utilisé est le service de géolocalisation de Google.
    • après iOS 6, le service utilisé est le service de géolocalisation de Apple.
  • iPhone/iPad Il est préférable d'utiliser la syntaxe 2 "Afficher une position géographique avec procédure de vérification".
  • Le niveau de zoom de la carte n’est pas modifié lors du changement de position.
  • Pour centrer la carte sur une position donnée sans effectuer d’animation, il est possible d’affecter directement une variable de type géoPosition à la propriété ..Valeur d’un champ Carte.
  • Android Pour récupérer la liste des adresses correspondant à la description d’un lieu ou à une position géographique, utilisez la fonction géoRécupèreAdresse.
  • WINDEVWEBDEV - Code NavigateurAndroidiPhone/iPadUniversal Windows 10 App Pour connaître la position actuellement affichée au centre du champ Carte, utilisez la fonction CarteRécupèrePosition.
  • Versions 21 et supérieures
    Universal Windows 10 App Le champ Carte utilise le service Bing Map.
    Attention : L'utilisation du champ Carte est soumise à 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.
    Nouveauté 21
    Universal Windows 10 App Le champ Carte utilise le service Bing Map.
    Attention : L'utilisation du champ Carte est soumise à 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.
    Universal Windows 10 App Le champ Carte utilise le service Bing Map.
    Attention : L'utilisation du champ Carte est soumise à 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.
  • iPhone/iPad Pour afficher sur une carte la position d'une adresse, il est conseillé de réaliser les opérations suivantes :
    1. Faire une requête HTTP sur Google MAP pour récupérer les coordonnées d'une adresse.
    2. Utiliser les coordonnées récupérées avec la fonction CarteAffichePosition.
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.
Composante : wd240obj.dll
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire