`) dans lequel on veut qu'elle s'affiche.

* un objet javascript, de type Gp.MapOptions contenant le paramétrage de la carte.

Elle retourne un objet de type Gp.Map avec lequel il sera ensuite possible d'intéragir.

Exemple : le code suivant :

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
// clef d'accès à la plateforme
apiKey: "APIKEY",
// chargement de la cartographie en 3D avec la librairie itowns
viewMode : "3d",

// centrage de la carte
center : {
location : "73 avenue de Paris, Saint-Mandé"
},
// niveau de zoom de la carte (de 1 à 21)
zoom : 17,
// Couches à afficher
layersOptions : {
"GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-EXPRESS.STANDARD" : {
}
},
// Outils additionnels à proposer sur la carte
controlsOptions : {
// ajout d'une barre de recherche
"search" : {
maximised : true
}
}
}
) ;
`

Permet, d'afficher une carte avec les options suivantes :

* utilisation des droits de la clef 'APIKEY' (Plus d'infos sur les possibilités de paramétrage des droits...);

* viewMode : "3d" pour un chargement de la cartographie en 3D, avec la librairie iTowns, ou "2d" (par défaut) pour un chargement de la cartographie en 2D, avec la librairie OpenLayers. Il sera ensuite possible de basculer d'un mode de visualisation à l'autre (Voir la partie "Bascule entre 2D et 3D).

centrage sur l'adresse "73 avenue de Paris, Saint-Mandé"* (en utilisant le service de géocodage du Géoportail) zoomée au niveau 17 ; (Plus d'infos sur les possibilités de centrage...)

fonds de carte : ressource Cartes SCAN Express Standard (GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-EXPRESS.STANDARD*). Plus d'infos sur le paramétrage des couches...;

outils additionnels : barre de recherche (controlsOptions*). Plus d'infos sur le paramétrage des outils additionnels... ;

Voir l'exemple complet sur jsFiddle




$3

Le SDK Géoportail exploite les services web exposés par la plateforme Géoportail. Ceux-ci sont soumis à l'obtention d'une clef d'accès obtenue sur le site professionnels.ign.fr ayant les droits sur les ressources que vous souhaitez exploiter.




$3

Une fois la clef obtenue, vous pouvez l'utiliser pour paramétrer le SDK à l'aide de la propriété apiKey lors de l'initialisation de la carte :


` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
...
// clef d'accès à la plateforme
apiKey: "APIKEY",
...
}
) ;
`

Lors du chargement de la carte, le SDK récupèrera automatiquement la configuration associée à votre clef et s'en servira pour paramétrer la carte en fonction des droits disponibles.




$3

Vous pouvez améliorer le temps de chargement de votre page en mettant en cache sur votre plateforme la configuration associée à votre clef d'accès. Il vous suffit pour cela de récupérer le fichier de configuration (autoconf.json) obtenu à l'aide du formulaire de ce tutoriel.

Enregistrez ce fichier sur votre plateforme et paramétrez le SDK à l'aide de la propriété configUrl lors de l'initialisation de la carte :

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
...
// configuration de l'accès à la plateforme
configUrl : "chemin/vers/autoconf.json",
...
}
) ;
`




$3

Le paramétrage du cente de la carte se fait à l'aide de la propriété center de l'objet mapOptions.

On peut centrer la carte de différentes façons :

#### Centrage par coordonnées

On précise les coordonnées à l'aide des propriétés x et y en y associant l'identifiant de la projection dans laquelle elles sont exprimées à l'aide de la propriété projection. Par défaut, la projection utilisée est celle de la carte. En 3D, seul le système de coordonnées géographiques WGS84 ("EPSG:4326") est utilisé.

Exemple :

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
// chargement de la cartographie en 3D avec la librairie itowns
library : "itowns",
// centrage de la carte
center : {
x : -4.620391,
y : 48.268698,
projection : "CRS:84"
},
}
) ;
`

Plus d'informations sur le paramétrage des projections ici.


#### Centrage en utilisant le service de géocodage du Géoportail

La propriété location permet de préciser le lieu à géocoder et la propriété locationType permet de préciser le type de Géocodage à appliquer, selon la terminologie suivante (rendez vous ici pour plus d'informations sur le service de Géocodage du Géoportail...) :

* "PositionOfInterest" : géocodage par noms de lieux

* "StreetAddress" : géocodage par adresses

* "CadastralParcels" : géocodage d'indentifants de parcelles cadastrales


Exemple :

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
// centrage de la carte
center : {
location : "73 avenue de Paris, Saint-Mandé",
locationType : ["StreetAddress"]
},
}
) ;
`

NB : Cette possibilité de centrage ne fonctionne que si la clef d'accès à la plateforme Géoportail utilisée pour paramétrer le SDK possède les droits nécessaires sur les ressources utilisées pour le Géocodage.


#### Centrage par géolocalisation du terminal utilisé

La propriété geolocate, si elle est positionée à true, permet de déclencher - sous réserve d'acceptation de l'internaute - une géolocalisation du terminal consultant la page et d'utiliser les coordonnées obtenues pour centrer la carte.

Exemple :

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
// chargement de la cartographie en 3D avec la librairie itowns
library : "itowns",
// centrage de la carte
center : {
geolocate : true
},
}
) ;
`

NB : on peut modifier le centre de la carte à tout moment après son chargement initial à l'aide de la méthode setCenter(), de l'objet map retourné par la fonction Gp.map.load(). Voir la partie "Interaction avec la carte"




$3

Le paramétrage des couches qui vont composer la carte se fait à l'aide de la propriété layersOptions de l'objet mapOptions.

C'est un objet javascript dont chaque propriété va représenter une couche composant la carte : la clef est un identifiant associé à la couche ; la valeur un objet de type Gp.LayerOptions permettant de préciser les caractéristiques de la couche à afficher.

Si cette propriété n'est pas renseignée, l'affichage se fera par défaut avec la couche des Photographies aériennes ("ORTHOIMAGERY.ORTHOPHOTOS") servie en images tuilées (WMTS) si la clef d'accès utilisée pour initialiser la carte en possède les droits.

Selon le type de couches à afficher ("Géoportail" ou externe), le paramétrage varie.


#### Affichage des couches Géoportail WMS et WMTS

Les couches Géoportail sont les couches auxquelles donne droit la clef utilisée pour paramétrer la carte. Pour ajouter une telle couche à la carte, il suffit d'utiliser son nom technique comme clef de l'objet layersOptions et de passer comme valeur associée, un objet javascript de type Gp.LayerOptions contenant, si besoin, des propriétés particulières ou vide si la configuration par défaut convient.

Pour afficher un MNT IGN dans un contexte 3D, il suffit de renseigner le paramètre "isElevation" à true.

Exemple 1 : ajout des couches WMTS Photographies aériennes et cartes avec une opacité de 30%.

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
...
// Couches à afficher
layersOptions : {
// Couche photographies aériennes
"ORTHOIMAGERY.ORTHOPHOTOS" : {},
// Couche photographies aériennes
"GEOGRAPHICALGRIDSYSTEMS.MAPS.SCAN-EXPRESS.STANDARD" : {
opacity : 0.3
}
}
...
}
) ;
`

Voir l'exemple complet sur jsFiddle


Exemple 2 : ajout de couches WMS INSPIRE servies par la plateforme Géoportail.

` javascript
var map = Gp.Map.load(
"map", // html div
{
...
layersOptions : {
"OI.OrthoimageCoverage" : {},
"BU.Building" : {}
}
...
}
) ;
`

Voir l'exemple complet sur jsFiddle

Exemple 3 : ajout d'une couche WMTS d'élévation avec la couche WMTS Photographies aériennes

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
...
// Couches à afficher
layersOptions : {
// Couche photographies aériennes
"ORTHOIMAGERY.ORTHOPHOTOS" : {},
// Couche MNT IGN
"ELEVATION.ELEVATIONGRIDCOVERAGE" : {
isElevation : true
}
}
...
}
) ;
`

Voir l'exemple complet sur jsFiddle


#### Affichage des couches "externes"

Les couches externes sont des données issues d'autres serveurs que ceux de la plateforme Géoportail. Pour ajouter de telles couches à la carte, vous utilisez un identifiant de votre choix comme clef de l'objet layersOptions et passez comme valeur associée, un objet javascript de type Gp.LayerOptions contenant le paramétrage nécessaire qui permettra au SDK d'afficher la couche.

Les formats supportés par le SDK pour les couches externes sont les suivants :

Pour les données images : WMS, WMTS (Open Street Map uniquement en 2D)

Pour les données vecteur : KML, GPX, GeoJSON (WFS uniquement en 2D)

Le type de couches à afficher, lorsqu'il ne s'agit pas d'une couche Géoportail, doit être passé via la propriété "format" de l'objet Gp.LayerOptions.


Exemple : ajout d'une couche WMS externe.


` javascript
var map = Gp.Map.load(
"map", // html div
{
...
layersOptions : {
"ORTHOIMAGERY.ORTHOPHOTOS" : {},
"ifremer-sables-languedoc" : {
title : "Sables Languedoc",
description :"IFREMER : Formations superficielles du précontinent Languedocien - Sable",
format : "WMS",
version : "1.3.0",
url : "http://www.ifremer.fr/services/wms/geosciences?",
layers : ["IFR_FACIESSABLE_GDL_1986_P"],
outputFormat : "image/png",
legends : [{
url : "http://www.ifremer.fr/services/wms/geosciences?version=1.3.0&service=WMS&request=GetLegendGraphic&sld_version=1.1.0&layer=IFR_FACIESSABLE_GDL_1986_P&format=image/png&STYLE=default",
format : "image/png"
}]
}
},
...
}
) ;
`

Voir l'exemple complet sur jsFiddle

NB : on peut ajouter, modifier ou retirer les couches de la carte à tout moment après son chargement initial à l'aide des méthodes addLayers(), modifyLayers() ou removeLayers() de l'objet map retourné par la fonction Gp.map.load(). Voir la partie "Interaction avec la carte"

$3

Le SDK 3D vous permet de rajouter des repères (markers) sur votre carte, mais uniquement pour un affichage 2D.
Cela se fait à l'aide de la propriété markersOptions de l'objet mapOptions.

Il s'agit d'un tableau javascript contenant autant d'éléments que de markers à rajouter. Chaque élément est un objet javascript de type Gp.MarkerOptions ; il permet de préciser les caractéristiques (positionnement, apparence, ...) du repère de positionnement à afficher.

Exemple : Positionnement d'un marker au centre de la carte.

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
...
// Repères visuels
markersOptions : [{
content : "

Pôle Géosciences

73 avenue de Paris, Saint-Mandé

Site Web

"
}],
...
}
) ;
`

Voir l'exemple complet sur jsFiddle

$3

Par défaut, la carte se présente :
- en 2D avec les boutons de zoom et l'affichage des attributions.
- en 3D avec l'affichage des attributions.
Le SDK 3D vous permet de rajouter des outils sur la carte qui vont permettre à l'internaute d'interagir avec la celle-ci. Attention : certains de ces outils ne sont disponibles que sur la visualisation 2D.

L'ajout d'outils se fait à l'aide de la propriété controlsOptions de l'objet mapOptions. Il s'agit d'un objet javascript dont chaque propriété a le nom de l'outil à rajouter et chaque valeur de propriété permet de préciser - si besoin - le paramétrage de l'outil. Ce paramétrage se fait à l'aide d'un objet javascript de type Gp.ControlOptions, dont les propriétés vont varier selon l'outil.

Les outils disponibles en 2D et 3D sont les suivants :

* gestionnaire de couches ("layerswitcher")

* affichage des producteurs de données ("attributions")

* mini vue ("overview") ;

* échelle graphique ("graphicscale") ;

* coordonnées de la souris ("mouseposition")

Les outils disponibles en 2D uniquement sont les suivants :

* boutons de zoom ("zoom") ;

* barre de recherche ("search")

* recherche inversée ("reversesearch")

* outils de dessin ("drawing")

* bouton d'orientation ("orientation") ;

* calcul d'isochrones ("isocurve")

* affichage d'une grille ("graticule")

* import de couches ("layerimport")

* calcul de distances ("length")

* calcul de surfaces ("area")

* calcul d'azimuth ("azimuth")

* calcul de profil altimétrique ("elevationpath")

NB : on peut ajouter, modifier ou retirer les outils de la carte à tout moment après son chargement initial à l'aide des méthodes addControls(), modifyControls() ou removeControls() de l'objet map retourné par la fonction Gp.map.load(). Voir la partie "Interaction avec la carte"

NB : lors d'une bascule d'une visualisation 2D vers 3D à l'aide de la fonction switch2D3D() , les outils non disponibles en 3D disparaitront de l'interface cartographique. Ils réapparaitront en cas de nouvelle bascule d'une visualisation 3D vers 2D.

$3

Le SDK permet d'écouter certains événements qui se produisent lorsque les internautes intéragissent avec la carte et de définir des comportements à appliquer lorsque ces événements se produisent.

Cela se fait à l'aide de la propriété mapEventsOptions de l'objet mapOptions.

Il s'agit d'un objet javascript dont les propriétés ont le nom de l'événement auquel on souhaite s'abonner et les valeurs associées sont des fonctions javascript à déclencher lorsque l'événement se produit. Chaque fonction prend comme paramètre un objet javascript représentant l'événement et ses propriétés qui vient de se produire.

Les événements auxquels on peut s'abonner sont les suivants :

* Evénements d'initialisation : "mapLoaded", "geolocated", "located", "configured"

* Evénements de changement d'état de la carte : "centerChanged", "zoomChanged" ,"azimuthChanged", "layerChanged", "tiltChanged"

Exemple : Déclenchement d'une alerte à la fin de l'initialisation de la carte.

` javascript
var map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
...
mapEventsOptions : {
// when map has finished to initialize and to render
"mapLoaded" : function(evt) {
alert("map ready !") ;
}
}
...
}
) ;
`

Voir l'exemple complet sur jsFiddle

NB : on peut s'abonner aux événements à tout moment après le chargement initial de la carte à l'aide de la méthode listen() de l'objet map retourné par la fonction Gp.map.load(). Voir la partie "Interaction avec la carte"

$3

Le SDK 3D permet de basculer d'une vue 2D à une vue 3D, et vice-versa. Pour cela, utiliser la fonction Gp.Map.switch2D3D(). Les couches, la position de la caméra, et les outils présents sur l'interface cartographique sont conservés lors de la bascule (hormis les outils disponibles qu'en 2D, plus d'infos).

Voir un exemple de bascule sur jsFiddle

$3

L'objet Gp.MapOptions permet de jouer sur d'autres paramètres de la carte lors de son initialisation avec la fonction Gp.Map.load(). Entre autres :

- la projection

- les niveaux de zoom courant, minimal et maximal

- l'orientation (azimuth) de la carte

- l'inclinaison (tilt) de la vue en 3D

- ...

$3

La fonction Gp.Map.load() retourne un objet de type Gp.Map avec lequel il sera possible d'interagir programmatiquement à partir du moment où l'événement "mapLoaded" sera émis.

Pour un bon fonctionnement, il faut donc conditionner les traitements ultérieurs au chargement de la carte à la réception de cet événement à l'aide de la propriété mapEventsOptions comme décrit précédemment. Un script javascript utilisant le SDK Géoportail aura donc l'allure générale suivante :

` javascript

var map = null ;

function afterInitMap() {
// le code de l'application interagissant avec la carte
// ici, l'objet map est initialisé.
...
}

// Chargement de la carte et initialisation de l'objet Map
map = Gp.Map.load(
"mapDiv", // identifiant du conteneur HTML
// options d'affichage de la carte (Gp.MapOptions)
{
apiKeys : "API-KEY",
...
mapEventsOptions : {
// Appel de la fonction après le chargement de la carte
"mapLoaded" : afterInitMap
}
...
}
) ;
``