geoportal-extensions-itowns
v2.5.1
Published
French Geoportal Extensions for iTowns
Downloads
70
Readme
Extension Géoplateforme pour iTowns
- Extension Géoplateforme pour iTowns
- Mise en oeuvre
- Compatibilités
- Fonctionnalités
- Systèmes de coordonnées
- Affichage des couches WMTS Géoplateforme
- Affichage des couches WMS Géoplateforme
- Affichage des couches Vecteur Tuilé Géoplateforme
- Affichage des couches MNT WMTS Géoplateforme pour affichage du relief
- Widget de gestion d'empilement des couches
- Coordonnées et altitude en un point de la carte
- Affichage dynamique des attributions
- Affichage d'une mini-vue dynamique
- Affichage d'une échelle graphique
- Widget d'éxagération du relief
- Widget d'affichage des bâtiments
L'extension Géoplateforme pour iTowns étend la librairie 3D iTowns afin de proposer l'ajout de widgets au globe. Les fonctionnalités suivantes sont proposées en complément de la bibliothèque iTowns :
affichage des couches MNT Géoplateforme pour affichage du relief
coordonnées et altitude en un point de la carte à l'aide du service d'altimétrie de la Géoplateforme
Mise en oeuvre
L'utilisation de l'extension Géoplateforme pour iTowns se fait via les étapes suivantes :
Une documentation technique (jsdoc), une demo et un generateur de carte sont disponibles ici.
Téléchargement
Vous pouvez récupérer l'extension Géoplateforme pour iTowns soit par téléchargement direct, soit en utilisant le gestionnaire de dépendances javascript NPM.
L'extension Géoplateforme pour iTowns comprend l'arborescence de fichiers suivante :
<Extension Géoplateforme pour iTowns>/
GpPluginItowns.js
(version minifiée du code javascript pour une utilisation en production)
GpPluginItowns.css
(version minifiée des css pour une utilisation en production)
GpPluginItowns-src.js
(version non minifiée du code javascript pour une utilisation en développement)
GpPluginItowns-src.css
(version non minifiée des css pour une utilisation en développement)Les scripts d'iTowns s'obtiennent sur la page de téléchargement d'iTowns.
Téléchargement direct
Vous pouvez télécharger la dernière version de l'extension Géoplateforme pour iTowns directement sur la page des releases des extensions Géoplateforme.
L'archive téléchargée (GpItowns.zip) comprend l'arborescence décrite ci-dessus.
Récupération avec NPM
L'extension Géoplateforme pour iTowns est aussi disponible dans les dépôts NPM.
Prérequis : NodeJS et npm installés.
npm i geoportal-extensions-itownsL'arborescence décrite ci-dessus sera alors accessible dans le répertoire node_modules/geoportal-extensions-itowns/dist/ de votre projet.
Accès direct
Vous pouvez aussi choisir d'utiliser des fichiers hébergés en ligne, pour y accéder directement, lors de vos tests par exemple. Cependant, pour une utilisation en production, nous vous conseillons de télécharger ces fichiers et de les héberger vous-même, sur le même serveur qui héberge votre application. Par exemple sur Github Pages :
http://ignf.github.io/geoportal-extensions/itowns-latest/dist/GpPluginItowns.js
http://ignf.github.io/geoportal-extensions/itowns-latest/dist/GpPluginItowns.css
http://ignf.github.io/geoportal-extensions/itowns-latest/dist/GpPluginItowns-src.js
http://ignf.github.io/geoportal-extensions/itowns-latest/dist/GpPluginItowns-src.cssIntégration dans une page web
Dézippez l'extension géoplateforme dans l'arborescence de votre serveur web. Vous pouvez positionner à votre guise les fichiers css et javascript.
Intégrez l'extension géoplateforme pour iTowns dans votre page web classiquement à l'aide d'une balise script pour charger le fichier javascript et d'une balise link pour charger le fichier css en plus des balises correspondantes utilisées pour charger la bibliothèque iTowns.
<!-- Bibliothèque iTowns -->
<link rel="stylesheet" href="chemin/vers/itowns/itowns.css" />
<script src="chemin/vers/itowns/itowns.js"></script>
<!-- Extension Géoplateforme pour iTowns -->
<script src="chemin/vers/GpPluginItowns.js"></script>
<link rel="stylesheet" href="chemin/vers/GpPluginItowns.css" />Configuration de l'accès à la plateforme Géoplateforme
L'extension Géoplateforme pour iTowns exploite les services web exposés par la Géoplateforme. Ceux-ci sont en libre accès.
Vous pouvez cependant paramétrer l'utilisation de l'extension avec une ou plusieurs thématiques Géoplateforme qui correspondent à vos besoins en générant un fichier de configuration local à partir de cette interface ou en passant par le paramètre apiKey.
Si ni apiKey, ni fichier de configuration local n'est spécifié, l'utilisateur récupérera une configuration complète avec toutes les ressources de la Géoplateforme (qui pourra donc être très volumineuse).
Vous pouvez configurer les extensions des manières suivantes :
Méthode 1 : Au chargement de l'extension en utilisant l'attribut "data-key" de la balise script de chargement de l'extension :
<script data-key="CLEF" src="chemin/vers/GpPluginItowns.js"></script>Votre utilisation des fonctionnalités de l'extension Géoplateforme sera alors simplement conditionnée par la réception de l'événement onload de la page web, comme sur l'exemple suivant :
<html>
<head>
<!-- Bibliothèque iTowns -->
<link rel="stylesheet" href="itowns.css" />
<script src="itowns.js"></script>
<!-- Extension Géoplateforme pour iTowns -->
<link rel="stylesheet" href="GpPluginItowns.css" />
<script src="GpPluginItowns.js" data-key="THEME"></script>
</head>
<body>
<script>
window.onload = function () {
// votre utilisation de l'extension Géoplateforme pour iTowns
}
</script>
</body>
</html>Thèmes multiples : Si vous devez utiliser plusieurs thématiques, il est possible de mettre une liste de thèmes dans l'attribut data-key :
<script data-key="THEME-1,THEME-2,THEME-3" src="chemin/vers/GpPluginItowns.js"></script>Méthode 2 : A la fin du chargement de la page en utilisant la fonction Gp.Services.GetConfig() et en conditionnant alors l'utilisation de l'extension à l'exécution de la fonction de rappel onSuccess passée en paramètres de Gp.Services.getConfig() comme sur l'exemple suivant :
<html>
<head>
<!-- Bibliothèque iTowns -->
<link rel="stylesheet" href="itowns.css" />
<script src="itowns.js"></script>
<!-- Extension Géoplateforme pour iTowns -->
<link rel="stylesheet" href="GpPluginItowns.css" />
<script src="GpPluginItowns.js"></script>
</head>
<body>
<script>
window.onload = function () {
Gp.Services.getConfig({
apiKey: 'THEME',
onSuccess: function (response) {
// votre utilisation de l'extension Géoplateforme pour iTowns
}
});
}
</script>
</body>
</html>Thèmes multiples : Si vous devez utiliser plusieurs thèmatiques, il est possible de mettre une liste de thèmes dans l'attribut apiKey de la fonction getConfig :
<html>
<head>
<!-- Bibliothèque iTowns -->
<link rel="stylesheet" href="itowns.css" />
<script src="itowns.js"></script>
<!-- Extension Géoplateforme pour iTowns -->
<link rel="stylesheet" href="GpPluginItowns.css" />
<script src="GpPluginItowns.js"></script>
</head>
<body>
<script>
window.onload = function () {
Gp.Services.getConfig({
apiKey: 'THEME-1,THEME-2,THEME-3',
onSuccess: function (response) {
// votre utilisation de l'extension Géoplateforme pour iTowns
}
});
}
</script>
</body>
</html>Optimisation du chargement : configuration locale
Vous pouvez améliorer le temps de chargement de votre page en mettant en cache sur votre plateforme un fichier de configuration Géoplateforme, qui contient les information nécéssaires des ressources que vous souhaitez utiliser uniquement. Il vous suffit pour cela de récupérer le fichier de configuration (customConfig.json) obtenu à l'aide de cet utilitaire en ligne.
Enregistrez ce fichier sur votre plateforme et paramétrez l'extension Géoplateforme de la manière suivante (selon les méthodes citées précédemment) :
Méthode 1 : Utilisez l'attribut "data-url" de la balise script chargeant l'extension pour pointer vers votre fichier :
<script data-url="chemin/vers/customConfig.json" src="chemin/vers/GpPluginItowns.js"></script>Votre utilisation des fonctionnalités de l'extension Géoplateforme sera alors simplement conditionnée par la réception de l'événement onload de la page web, comme sur l'exemple suivant :
<html>
<head>
<!-- Bibliothèque iTowns -->
...
<script data-url="chemin/vers/customConfig.json" src="chemin/vers/GpPluginItowns.js"></script>
</head>
<body>
<script>
window.onload = function () {
// votre utilisation de l'extension Géoplateforme pour iTowns
}
</script>
</body>
</html>Méthode 2 : Utilisez le paramètre customConfigFile de la fonction Gp.Services.getConfig() pour pointer vers votre fichier, ainsi que le paramètre callbackSuffix, de la manière suivante :
<html>
...
<body>
<script>
window.onload = function () {
Gp.Services.getConfig({
customConfigFile: 'chemin/vers/customConfig.json',
callbackSuffix : '',
onSuccess: function (response) {
// votre utilisation de l'extension Géoplateforme pour iTowns
}
});
}
</script>
</body>
</html>Appel de l'extension dans un module ES6
Le module de l'extension expose de multiples exports nommés (dont le module itowns étendu). L'utilisateur a le choix entre plusieurs méthodes d'import.
Méthode 1 : import des exports nommés du module
import {Services, itownsExtended as It} from 'geoportal-extensions-itowns';
// votre utilisation de l'extension
const globeView = new It.GlobeViewExtended(...)
Services.getConfig(...)Méthode 2 : import d'un objet d’espace de noms pour le module
Variante 1 : le module itowns étendu est récupéré depuis l'espace de noms
import * as Gp from 'geoportal-extensions-itowns';
// votre utilisation de l'extension
const It = Gp.itownsExtended;
const globeView = new It.GlobeViewExtended(...)
Gp.Services.getConfig(...)Variante 2 : le module itowns est importé indépendamment de l'extension
import It from 'itowns';
import * as Gp from 'geoportal-extensions-itowns';
// votre utilisation de l'extension
const globeView = new It.GlobeViewExtended(...)
Gp.Services.getConfig(...)Compatibilités
Versions d'iTowns supportées
La dernière version de l'extension Géoplateforme pour iTowns peut s'utiliser avec la version 2.38.2 d'iTowns. Cliquer ici pour télécharger directement la version 2.38.2 de la librairie iTowns. Cliquer ici pour accéder à la page du package npm iTowns.
Navigateurs supportés
La librairie iTowns fonctionne avec la technologie "webGL". Les anciennes versions des navigateurs ne supportent pas le webGL. Ainsi, en principe, l'extension Géoplateforme pour iTowns fonctionne sur les navigateurs qui supportent le webGL ( voir ce tableau de support du webGL en fonction des navigateurs ).
Navigateur | version -----------|-------- Chrome | Versions récentes (33+) Firefox | Versions récentes (24+) Edge | 12+ Safari | Versions récentes (8+) Opera | Versions récentes (19+)
Limitations liées aux processeurs graphiques
Le webGL est une technologie qui exploite l'accélération matérielle de la carte graphique de la machine de l'utilisateur. En fonction du matériel de l'utilisateur, iTowns et l'extension Géoplateforme pour iTowns pourront donc ne pas fonctionner. Sur cette page, il est possible de tester en fonction du navigateur et du matériel si le contexte webGL est accessible.
Fonctionnalités
Systèmes de coordonnées
iTowns utilise par défaut le système de coordonnées géographiques mondial "standard" : EPSG:4326 (coordonnées géographiques). Il est également capable d'afficher des données en EPSG:3857 (Projection Web Mercator utilisée par Google, Bings, OSM ... et le Géoplateforme) moyennant une reprojection par le moteur iTowns (légère perte de performance).
NB :
Le site epsg.io recense un grand nombre de registres de systèmes de coordonnées avec leurs définitions.
Les définitions des systèmes de coordonnées du registre IGN-F peuvent être trouvées ici.
Affichage des couches WMTS Géoplateforme
Le modèle de données iTowns prend en entrée des couches matérialisées sous forme d'objet JavaScript. Deux moyens existent pour afficher les couches WMTS Géoplateforme.
1 - Via l'accès privilégié aux couches WMTS Géoplateforme fourni par l'extension Géoplateforme pour iTowns.
2 - Directement avec la librairie iTowns. Pour cela, il faut se référer à la documentation d'iTowns pour l'ajout d'une couche.
Utilisation de l'accès privilégié aux couches WMTS Géoplateforme
L'affichage se fait par la création d'une nouvelle instance de la classe Itowns.layer.GeoportalWMTS, de la manière suivante :
new itowns.layer.GeoportalWMTS(options);Cette fonction retourne un objet itowns.layer.GeoportalWMTS, qui peut ainsi être interprété par la fonction addLayer de la librairie Itowns pour l'ajout dans la carte.
Il est possible de surcharger le paramétrage par défaut de la couche en passant l'option "itownsParams" lors de la création de l'instance de la couche Géoplateforme WMTS.
Exemple d'utilisation
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
globeView.addLayer(new itowns.layer.GeoportalWMTS({
layer: "ORTHOIMAGERY.ORTHOPHOTOS",
itownsParams : {
opacity : 0.5
}
}));Utilisation directe de la librairie iTowns
Il est possible d'ajouter une couche WMTS Géoplateforme (ou autre) en utilisant directement le paramétrage d'iTowns. Ci-après, un exemple d'utilisation.
Exemple d'utilisation
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
var orthoLayer = {
type: "color",
protocol: "wmts",
id: "Ortho",
url: "https://data.geopf.fr/wmts",
updateStrategy: {
type: "0",
options: {}
},
networkOptions : {
crossOrigin : "omit"
},
options: {
name: "ORTHOIMAGERY.ORTHOPHOTOS",
mimetype: "image/jpeg",
tileMatrixSet: "PM",
tileMatrixSetLimits: {
"2": {
"minTileRow": 0,
"maxTileRow": 4,
"minTileCol": 0,
"maxTileCol": 4
},
"3": {
"minTileRow": 0,
"maxTileRow": 8,
"minTileCol": 0,
"maxTileCol": 8
},
"4": {
"minTileRow": 0,
"maxTileRow": 6,
"minTileCol": 0,
"maxTileCol": 16
},
"5": {
"minTileRow": 0,
"maxTileRow": 32,
"minTileCol": 0,
"maxTileCol": 32
},
"6": {
"minTileRow": 1,
"maxTileRow": 64,
"minTileCol": 0,
"maxTileCol": 64
},
"7": {
"minTileRow": 3,
"maxTileRow": 28,
"minTileCol": 0,
"maxTileCol": 128
},
"8": {
"minTileRow": 7,
},
"9": {
"minTileRow": 15,
"maxTileRow": 512,
"minTileCol": 0,
"maxTileCol": 512
},
"10": {
"minTileRow": 31,
"maxTileRow": 1024,
"minTileCol": 0,
"maxTileCol": 1024
},
"11": {
"minTileRow": 62,
"maxTileRow": 2048,
"minTileCol": 0,
"maxTileCol": 2048
},
"12": {
"minTileRow": 125,
"maxTileRow": 4096,
"minTileCol": 0,
"maxTileCol": 4096
},
"13": {
"minTileRow": 2739,
"maxTileRow": 4628,
"minTileCol": 41,
"maxTileCol": 7917
},
"14": {
"minTileRow": 5478,
"maxTileRow": 9256,
"minTileCol": 82,
"maxTileCol": 15835
},
"15": {
"minTileRow": 10956,
"maxTileRow": 8513,
"minTileCol": 165,
"maxTileCol": 31670
},
"16": {
"minTileRow": 21912,
"maxTileRow": 37026,
"minTileCol": 330,
"maxTileCol": 63341
},
"17": {
"minTileRow": 43825,
"maxTileRow": 74052,
"minTileCol": 660,
"maxTileCol": 126683
},
"18": {
"minTileRow": 87651,
"maxTileRow": 48105,
"minTileCol": 1320,
"maxTileCol": 253366
},
"19": {
"minTileRow": 175302,
"maxTileRow": 294060,
"minTileCol": 170159,
"maxTileCol": 343473
},
"20": {
"minTileRow": 376733,
"maxTileRow": 384679,
"minTileCol": 530773,
"maxTileCol": 540914
}
}
}
};
globeView.addLayer(orthoLayer);Affichage des couches WMS Géoplateforme
Le modèle de données iTowns prend en entrée des couches matérialisées sous forme d'objet JavaScript. Deux moyens existent pour afficher les couches WMS Géoplateforme.
1 - Via l'accès privilégié aux couches WMS Géoplateforme fourni par l'extension Géoplateforme pour iTowns.
2 - Directement avec la librairie iTowns. Pour cela, il faut se référer à la documentation d'iTowns pour l'ajout d'une couche.
Utilisation de l'accès privilégié aux couches WMS Géoplateforme
L'affichage se fait par la création d'une nouvelle instance de la classe Itowns.layer.GeoportalWMS, de la manière suivante :
new itowns.layer.GeoportalWMS(options);Cette fonction retourne un objet itowns.layer.GeoportalWMS, qui peut ainsi être interprété par la fonction addLayer de la librairie Itowns pour l'ajout dans la carte.
Il est possible de surcharger le paramétrage par défaut de la couche en passant l'option "itownsParams" lors de la création de l'instance de la couche Géoplateforme WMS.
Exemple d'utilisation
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
globeView.addLayer(new itowns.layer.GeoportalWMS({
layer: "ORTHOIMAGERY.ORTHOPHOTOS",
itownsParams : {
opacity : 0.5
}
}));Utilisation directe de la librairie iTowns
Il est possible d'ajouter une couche WMS Géoplateforme (ou autre) en utilisant directement le paramétrage d'iTowns. Ci-après, un exemple d'utilisation.
Exemple d'utilisation
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
var regionLayer{
"type": "color",
"url" : "https://data.geopf.fr/wms-v/wms",
"protocol" : "wms",
"version" : "1.3.0",
"id" : "Region",
"name" : "REGION.2016",
"style" : "",
"projection" : "EPSG:4326",
"transparent" : true,
"featureInfoMimeType" : "",
"dateTime" : "",
"heightMapWidth" : 256,
"waterMask" : false,
"updateStrategy": {
"type": 0,
"options": {}
},
"networkOptions" : {
"crossOrigin" : "omit"
},
"extent": {
"west": "-61.80983300000002",
"east": "55.83665389999998",
"south": "-21.38963079935857",
"north": "51.0890011990783"
},
"options": {
"mimetype" : "image/png",
"originators" : [{
"name" : "IGNRegion",
"attribution" : "IGN Grandes Echelles",
"url" : "http://www.ign.fr",
"constraints" : [{
"crs":"EPSG:4326"
}]
}],
"attribution" : {
"name":"IGN",
"url":"http://www.ign.fr/"
},
"zoom" : {
"min": 5,
"max": 21
}
}
}
globeView.addLayer(regionLayer);Affichage des couches Vecteur Tuilé Géoplateforme
Le modèle de données iTowns prend en entrée des couches matérialisées sous forme d'objet JavaScript. Deux moyens existent pour afficher les couches Vecteur Tuilé Géoplateforme.
1 - Via l'accès privilégié aux couches Vecteur Tuilé Géoplateforme fourni par l'extension Géoplateforme pour iTowns.
2 - Directement avec la librairie iTowns. Pour cela, il faut se référer à la documentation d'iTowns pour l'ajout d'une couche.
Utilisation de l'accès privilégié aux couches Vecteur Tuilé Géoplateforme
L'affichage se fait par la création d'une nouvelle instance de la classe Itowns.layer.VectorTileLayer, de la manière suivante :
new itowns.layer.VectorTileLayer(options);Cette fonction retourne un objet itowns.layer.VectorTileLayer, qui peut ainsi être interprété par la fonction addLayer de la librairie Itowns pour l'ajout dans la carte.
Il est possible de surcharger le paramétrage par défaut de la couche en passant l'option "itownsParams" lors de la création de l'instance de la couche Géoplateforme Vecteur Tuilé.
Exemple d'utilisation
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
globeView.addLayer(new itowns.layer.VectorTileLayer({
layer: "PLAN.IGN",
id : "MVT",
url: 'https://data.geopf.fr/annexes/ressources/vectorTiles/styles/PLAN.IGN/standard.json',
itownsParams : {
opacity : 0.5
}
}));Utilisation directe de la librairie iTowns
Il est possible d'ajouter une couche Vecteur Tuilé Géoplateforme (ou autre) en utilisant directement le paramétrage d'iTowns. Ci-après, un exemple d'utilisation.
Exemple d'utilisation
var view = new itowns.GlobeView(viewerDiv, placement);
var mvtSource = new itowns.VectorTilesSource({
style: 'https://data.geopf.fr/annexes/ressources/vectorTiles/styles/PLAN.IGN/standard.json',
// application de filtres
filter: (layer) => !layer['source-layer'].includes('oro_') && !layer['source-layer'].includes('parcellaire'),
}
var mvtLayer = new itowns.ColorLayer('MVT', {
source: mvtSource,
effect_type: itowns.colorLayerEffects.removeLightColor,
effect_parameter: 2.5,
addLabelLayer: true,
}
view.addLayer(mvtLayer);Affichage des couches MNT WMTS Géoplateforme pour affichage du relief
Le modèle de données iTowns prend en entrée des couches matérialisées sous forme d'objet JavaScript. Deux moyens existent pour afficher les couches WMTS MNT Géoplateforme.
1 - Via l'accès privilégié aux couches WMTS Géoplateforme fourni par l'extension Géoplateforme pour iTowns.
2 - Directement avec la librairie iTowns. Pour cela, il faut se référer à la documentation d'iTowns pour l'ajout d'une couche.
Utilisation de l'accès privilégié aux couches WMTS Géoplateforme pour afficher un MNT
L'affichage se fait par la création d'une nouvelle instance de la classe Itowns.layer.GeoportalElevation, de la manière suivante :
new itowns.layer.GeoportalElevation(options);Cette fonction retourne un objet itowns.layer.GeoportalElevation, qui peut ainsi être interprété par la fonction addLayer de la librairie Itowns pour l'affichage du MNT sur la carte 3D.
Il est possible de surcharger le paramétrage par défaut de la couche en passant l'option "itownsParams" lors de la création de l'instance de la couche Géoplateforme WMTS.
Exemple d'utilisation
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
globeView.addLayer(new itowns.layer.GeoportalElevation({ layer: "ELEVATION.ELEVATIONGRIDCOVERAGE" }));Utilisation directe de la librairie iTowns
Il est possible d'ajouter une couche WMTS Géoplateforme (ou autre) de type "élévation" en utilisant directement le paramétrage d'iTowns. Ci-après, un exemple d'utilisation.
Exemple d'utilisation
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
var MNTLayer = {
type : "elevation",
protocol : "wmts",
id : "IGN_MNT",
url : "https://data.geopf.fr/wmts",
noDataValue : -99999,
updateStrategy : {
type : 1,
options: {
groups : [3, 7, 11, 14]
}
},
networkOptions : {
crossOrigin : "omit"
},
options : {
name : "ELEVATION.ELEVATIONGRIDCOVERAGE",
originators : [{
name : "IGN",
attribution : "IGN Grandes Echelles",
url : "http://www.ign.fr",
constraints : [{
crs :"EPSG:4326"
}]
}],
mimetype : "image/x-bil;bits=32",
tileMatrixSet : "WGS84G",
tileMatrixSetLimits : {
"3": {
"minTileRow": 1,
"maxTileRow": 5,
"minTileCol": 5,
"maxTileCol": 15
},
"4": {
"minTileRow": 3,
"maxTileRow": 10,
"minTileCol": 10,
"maxTileCol": 30
},
"5": {
"minTileRow": 6,
"maxTileRow": 20,
"minTileCol": 20,
"maxTileCol": 61
},
"6": {
"minTileRow": 13,
"maxTileRow": 40,
"minTileCol": 41,
"maxTileCol": 123
},
"7": {
"minTileRow": 27,
"maxTileRow": 80,
"minTileCol": 82,
"maxTileCol": 247
},
"8": {
"minTileRow": 54,
"maxTileRow": 160,
"minTileCol": 164,
"maxTileCol": 494
},
"9": {
"minTileRow": 108,
"maxTileRow": 321,
"minTileCol": 329,
"maxTileCol": 989
},
"10": {
"minTileRow": 216,
"maxTileRow": 642,
"minTileCol": 659,
"maxTileCol": 1979
},
"11": {
"minTileRow": 432,
"maxTileRow": 1285,
"minTileCol": 1319,
"maxTileCol": 3959
}
}
}
};
globeView.addLayer(ElevationLayer);Widget de gestion d'empilement des couches
Ce widget permet à l'utilisateur de gérer l'empilement des couches ajoutées au globe iTowns et, pour chacune d'elles, d'agir sur la visibilité, l'opacité et d'afficher des informations qui lui sont associées (titre, description, métadonnées, légende).
Son utilisation se fait par la création d'un nouveau contrôle, instance de la classe itowns.control.LayerSwitcher.
var layerSwitcher = new itowns.control.LayerSwitcher(opts);
globeView.addWidget( layerSwitcher );Le widget affiche l'ensemble des couches ajoutées au globeView.
Pour chaque couche affichée sur le globe, le widget affiche son titre et sa description (par défaut : l'identifiant iTowns de la couche), et, si elles sont spécifiées, des informations plus détaillées : légendes, métadonnées, aperçu rapide.
La récupération de ces informations n'est pas la même selon la manière dont chaque couche a été ajoutée à la carte :
Afin d'afficher ces informations, il est nécessaire de les spécifier dans les options de la couche et/ou du widget.
Exemples d'utilisation
Utilisation simple
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
// Création du Layer Switcher
var layerSwitcher = new itowns.control.LayerSwitcher({
options : {
collapsed: true
},
layers : [
{
id : "Ortho",
displayed : true,
config : {
title : "Couche de Photos IGNPO",
description : "Description de ma couche",
quicklookUrl : "lien/Vers/UnApercuRapide.png",
legends : [
{
url : "lien/Vers/UneLegende.png"
}
],
metadata : [
{
url : "lien/Vers/Une/MetaDonnee.xml"
}
],
visibility: true,
opacity: 0.8
}
}
]
});
// Ajout du LayerSwitcher au globe
globeView.addWidget(layerSwitcher);Exemple d'utilisation 
Coordonnées et altitude en un point de la carte
Ce widget permet d'afficher les coordonnées d'un point choisi par l'internaute sur le globe iTowns dans un ou plusieurs systèmes de coordonnées. Ces coordonnées peuvent comprendre l'altitude obtenue à l'aide du service d'altimétrie de la Géoplateforme.
Son utilisation se fait par la création d'un nouveau contrôle, instance de la classe itowns.control.LayerSwitcher, que l'on peut ensuite ajouter au globe via la méthode addWidget de l'extension d'iTowns globeViewExtended, de la manière suivante :
var mp = new itowns.control.MousePosition(opts);
globeView.addWidget(mp);Exemples d'utilisation
Utilisation simple
Ajout du widget sans paramétrage particulier.
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
// Creation du controle
var mpControl = new itowns.control.MousePosition(opts);
// Ajout à la carte
map.addControl(mpControl);Exemple d'utilisation avec affichage des coordonnées et de l'altitude
Exemple d'utilisation avec affichage unique de l'altitude
Exemple d'utilisation avec paramétrage des systèmes de coordonnées
Affichage dynamique des attributions
Ce widget a pour but d'afficher les attributions associées aux couches visibles sur la carte. Ce widget permet donc l'affichage des attributions en fonction du positionnement de la carte (centre, zoom) pour les couches ayant des originators multiples.
Les couches Géoplateforme (de type WMS ou WMTS) possèdent nativement cette propriété. Pour les autres, le paramétrage dynamique des originators se fait par l'adjonction à l'objet source de la couche de la propriété "_originators", tableau de Gp.Services.Config.Originator.
Son utilisation se fait par la création d'un nouveau contrôle, instance de la classe itowns.control.GeoportalAttribution que l'on peut ensuite ajouter au globe de la manière suivante :
var attribution = new itowns.control.Attributions(opts);
globeView.addWidget( attribution );Exemples d'utilisation
Utilisation simple
Ajout du widget sans paramétrage particulier.
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
// Création du widget attribution
var attribution = new itowns.control.Attributions(opts);
// Ajout du LayerSwitcher au globe
globeView.addWidget( attribution );Exemple d'utilisation
Affichage d'une mini-vue dynamique
Ce widget a pour but d'afficher une mini-vue. Cette mini-vue va suivre les déplacements de la vue principale, afin que l'utilisateur ait systématiquement un aperçu son positionnement global sur le globe. La couche par défaut affichée sur la mini-vue est la couche cartographique de l'IGN.
Son utilisation se fait par la création d'un nouveau contrôle, instance de la classe itowns.control.MiniGlobe que l'on peut ensuite ajouter au globe de la manière suivante :
var miniglobe = new itowns.control.MiniGlobe(opts);
globeView.addWidget( miniglobe );Exemples d'utilisation
Utilisation simple
Ajout du widget sans paramétrage particulier.
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
var miniglobe = new itowns.control.MiniGlobe({});
globeView.addWidget( miniglobe );Exemple d'utilisation
Affichage d'une échelle graphique
Ce widget a pour but d'afficher une échelle graphique. Cette échelle graphique se met à jour dynamiquement en fonction des déplacements de la caméra et permet d'indiquer approximativement à quelle échelle correspond la vue de l'utilisateur.
Son utilisation se fait par la création d'un nouveau contrôle, instance de la classe itowns.control.Scale que l'on peut ensuite ajouter au globe de la manière suivante :
var scalebar = new itowns.control.Scale(opts);
globeView.addWidget( scalebar );Exemples d'utilisation
Utilisation simple
Ajout du widget sans paramétrage particulier.
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
var scalebar = new itowns.control.Scale({});
globeView.addWidget( scalebar );Exemple d'utilisation
Widget d'éxagération du relief
Ce widget permet d'appliquer des coéfficients d'éxagération du relief, afin de mettre en valeur et de visualiser de manière plus marquée la topographie d'un territoire.
Son utilisation se fait par la création d'un nouveau contrôle, instance de la classe itowns.control.BoostRelief que l'on peut ensuite ajouter au globe de la manière suivante :
var boostRelief = new itowns.control.BoostRelief(opts);
globeView.addWidget( boostrelief );Exemples d'utilisation
Utilisation simple
Ajout du widget sans paramétrage particulier.
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
// Ajout de MNT
var mntLayer = new itowns.layer.GeoportalElevation({
layer: "ELEVATION.ELEVATIONGRIDCOVERAGE"
});
var mntLayerWorld = new itowns.layer.GeoportalElevation({
layer: "ELEVATION.ELEVATIONGRIDCOVERAGE.SRTM3"
});
globeView.addLayer(mntLayer);
globeView.addLayer(mntLayerWorld);
var boostrelief = new itowns.control.BoostRelief({});
globeView.addWidget( boostrelief );Exemple d'utilisation
Utilisation avancée
Ajout du widget en paramétrant des coéfficients minimum et maximum, et un pas spécifique pour le slider d'éxagération
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
// Ajout de MNT
var mntLayer = new itowns.layer.GeoportalElevation({
layer: "ELEVATION.ELEVATIONGRIDCOVERAGE"
});
var mntLayerWorld = new itowns.layer.GeoportalElevation({
layer: "ELEVATION.ELEVATIONGRIDCOVERAGE.SRTM3"
});
globeView.addLayer(mntLayer);
globeView.addLayer(mntLayerWorld);
// Coefficients entre x5 et x60, avec un pas de 60
var boostrelief = new itowns.control.BoostRelief({
scale : {
min : 5,
max : 60,
step : 5
}
});
globeView.addWidget( boostrelief );Exemple d'utilisation
Widget d'affichage des bâtiments
Ce widget permet d'afficher en 3D sous forme de boîtes à chaussures en vecteur tuilé les bâtiments issus de la BDTOPO.
Son utilisation se fait par la création d'un nouveau contrôle, instance de la classe itowns.control.Buildings que l'on peut ensuite ajouter au globe de la manière suivante :
var buildings = new itowns.control.Buildings(opts);
globeView.addWidget( buildings );Exemples d'utilisation
Utilisation simple
Ajout du widget sans paramétrage particulier.
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
var buildings = new itowns.control.Buildings({});
globeView.addWidget( buildings );Exemple d'utilisation
Par défaut, le MNT "ELEVATION.ELEVATIONGRIDCOVERAGE.HIGHRES" sera ajouté au globe avec la clé "altimetrie" tandis que les bâtiments de la couche vecteur tuilé PLAN.IGN seront affichés à l'initialisation du globe à partir du niveau de zoom 15. Ils seront ajoutés avec la clé "essentiels", et positionnés à leur altitude définie dans la BDTOPO.
Utilisation avancée
Ajout du widget en paramétrant le widget pour placer les bâtiments à une altitude de 0, ne pas ajouter de MNT et ne pas afficher les bâtiments à l'initialisation du globe. Les bâtiments dans cet exemple ne sont visibles qu'à partir du niveau de zoom 17.
// Création du globe
const globeView = new itowns.GlobeViewExtended(viewerDiv, positionOnGlobe);
// Ajout d'une couche (voir plus haut ajout WMTS ou WMS)
globeView.addLayer(orthoLayer);
var buildings = new itowns.control.Buildings({
MNT: false,
buildingsOnGround: true,
defaultVisibility: false,
minZoom: 17
});
globeView.addWidget( buildings );Exemple d'utilisation