DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WINDEV, WEBDEV et WINDEV Mobile 2024 !
Aide / WLangage / Gestion des bases de données / HFSQL / Gestion des données spatiales
  • Parcours des données spatiales : utilisation des index spatiaux
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Permet de savoir si une géométrie A couvre une géométrie B.
Remarques :
  • Si la géométrie A couvre la géométrie B, tout point de la géométrie B se trouve à l'intérieur ou dans le contour de la géométrie A. Dans ce cas, il n'existe aucun point de la géométrie B à l'extérieur de la géométrie A.
  • Différence par rapport à la fonction GéométrieContient : Avec la fonction GéométrieCouvre, il n'est pas nécessaire d'avoir un point de l'intérieur de la géométrie B à l'intérieur de la géométrie A. Ainsi, un polygone couvre son contour, mais il ne le contient pas.
Avertissement
A partir de la version 2024 Update 2, cette fonction a été renommée. Dans les versions précédentes, cette fonction avait pour nom FormeCouvre.
Exemple
// Création d'un grand polygone
oPolygone2D_1 est un Polygone2D
Polyligne2DAjoutePoint(oPolygone2D_1.Contour, -5.00, 3.00)
Polyligne2DAjoutePoint(oPolygone2D_1.Contour, 4.00, 5.00)
Polyligne2DAjoutePoint(oPolygone2D_1.Contour, 4.00, -3.00)
Polyligne2DAjoutePoint(oPolygone2D_1.Contour, -4.00, -3.00)
// Ajout du dernier point (identique au premier)
Polyligne2DAjoutePoint(oPolygone2D_1.Contour, -5.00, 3.00)

// Création d'un plus petit polygone, à l'intérieur du grand
oPolygone2D_2 est un Polygone2D
Polyligne2DAjoutePoint(oPolygone2D_2.Contour, -2.00, 1.00)
Polyligne2DAjoutePoint(oPolygone2D_2.Contour, 3.00, 1.00)
Polyligne2DAjoutePoint(oPolygone2D_2.Contour, 0.00, -1.00)
// Ajout du dernier point (identique au premier)
Polyligne2DAjoutePoint(oPolygone2D_2.Contour, -2.00, 1.00)

// Tests des fonctions GéométrieCouvre et GéométrieContient
//--------------------------------------------------
GéométrieCouvre(oPolygone2D_1, oPolygone2D_2) // Vrai
GéométrieContient(oPolygone2D_1, oPolygone2D_2) // Vrai également

GéométrieCouvre(oPolygone2D_1, oPolygone2D_1.Contour) // Vrai : un polygone COUVRE son contour !
GéométrieContient(oPolygone2D_1, oPolygone2D_1.Contour) // Faux : un polygone ne CONTIENT PAS son contour !
Syntaxe
<Résultat> = GéométrieCouvre(<Géométrie A> , <Géométrie B>)
<Résultat> : Booléen
  • Vrai si la géométrie A couvre la géométrie B,
  • Faux dans le cas contraire.
En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Géométrie A> : Variable correspondant à des données spatiales
Nom de la variable correspondant à la première géométrie manipulée. Cette géométrie peut correspondre à un des types de variables suivants :
<Géométrie B> : Variable correspondant à des données spatiales
Nom de la variable correspondant à la seconde géométrie manipulée. Cette géométrie peut correspondre à un des types de variables suivants :
Remarques

Parcours des données spatiales : utilisation des index spatiaux

Il est possible d'effectuer un parcours sur un fichier de données avec un filtre concernant des données spatiales. Par exemple, le filtre utilisé peut être basé sur le résultat de la fonction GéométrieCouvre.
Pour optimiser ce filtre sur des données spatiales, il est recommandé d'utiliser les index spatiaux via la syntaxe suivante :
POUR TOUT Fichier AVEC Fonction_WLangage(Fichier.RubriqueSpatiale, variable_spatiale)

où :
  • Fonction_WLangage correspond à la fonction GéométrieCouvre.
  • Rubrique_spatiale correspond à une rubrique spatiale du fichier de données. Cette rubrique doit :
    • être de type "Données géographiques" ou de type "Données géométriques".
    • être définie comme une "Clé spatiale".
  • Variable_spatiale correspond à une variable spatiale donnée, utilisée pour la comparaison avec la rubrique spatiale. Cette variable est par exemple, une variable de type PolygoneGéo, Polygone2D, etc.
Remarque : Bien que disponible, la syntaxe "POUR TOUT Fichier" n'est pas recommandée car cette syntaxe n'utilisant pas les index spatiaux, ses performances ne sont pas optimisées. Effet, dans ce cas, tout le fichier de données est parcouru : les index spatiaux ne sont pas utilisés.
POUR TOUT Fichier
SI Fonction_WLangage(Fichier.Rubrique_spatiale, Variable_spatiale) = Vrai ALORS
   ...
   FIN
FIN
Exemple :
// Définition d'un triangle délimitant une zone géographique
// Mémorisation de ce triangle dans une variable de type PolygoneGéo 
polyGeo est un PolygoneGéo
polyGeo.Contour.AjoutePoint(0n48.8187479172765, 0n1.9550104465229536)
polyGeo.Contour.AjoutePoint(0n48.685649220185574, 0n2.023674998054354)
polyGeo.Contour.AjoutePoint(0n48.82612543243871, 0n2.2106580854197566)
polyGeo = GéométrieCorrige(polyGeo)

// Recherche les communes ayant un territoire dans le triangle ciblé
nbEnregs est un entier
POUR CHAQUE DatasCommunes AVEC GéométrieCouvre(DatasCommunes.geometry, polyGeo)
	// Nom de la commune dans une trace
	Trace(DatasCommunes.NomCommune)
FIN
Classification Métier / UI : Code métier
Composante : wd290hf.dll
Version minimum requise
  • Version 2024
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/05/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale