Class: Mapviewer

core~ Mapviewer

Créer une nouvelle carte MapViewer


new Mapviewer(options, projections, scaleLineOptions)

Parameters:
Name Type Argument Default Description
options Object

Options

Properties
Name Type Argument Default Description
mapdiv string <optional>
<nullable>
'map'

Identifiant de la div qui reçevra la carte.

projection string <optional>
<nullable>
'EPSG:3857'

Système de projection de la carte.

defaultCenter ol.coordinate <optional>
<nullable>
[0,0]

Centre par défaut de la carte.

defaultZoom number <optional>
<nullable>
10

Niveau de zoom par défault de la carte.

maxZoom number <optional>
<nullable>
28

Niveau de zoom maximal.

minZoom number <optional>
<nullable>
0

Niveau de zoom minimal.

moveTolerance number <optional>
<nullable>
1

The minimum distance in pixels the cursor must move to be detected as a map move event instead of a click. Increasing this value can make it easier to click on the map

hitTolerance number <optional>
<nullable>
0

Tolérence de précision en pixel sur la sélection.

strict boolean <optional>
<nullable>
false

Effectu la vérification d'ajout sur une toolbar lors de l'ajout de controls.

interactions Object

Configuration des interaction présente. Par défaut, toutes présentes.

Properties
Name Type Argument Default Description
altShiftDragRotate boolean <optional>
true

Rotation de la carte avec Alt-Shift-Drag. Par défaut True

doubleClickZoom boolean <optional>
true

Zoom avec un double clic. Par défaut True

keyboard boolean <optional>
true

Interaction avec le clavier si possible (zoom avec + et -, déplacement avec flèches). Par défaut True

mouseWheelZoom boolean <optional>
true

Zoom avec la molette de la souris. Par défaut True

customMouseWheelZoom object

Zoom personnalisé avec la molette de la souris. Par défaut undefined

Properties
Name Type Description
condition string

Condition de prise en charge du zoom. (altKeyOnly, altShiftKeysOnly, noModifierKeys, platformModifierKeyOnly, shiftKeyOnly)

shiftDragZoom boolean <optional>
true

Zoom sur zone avec Shift-Drag. Par défaut True

dragPan boolean <optional>
true

Déplacement avec le pan (appareils tactiles uniquement). Par défaut True

pinchRotate boolean <optional>
true

Rotation avec pinch (appareils tactiles uniquement). Par défaut True

pinchZoom boolean <optional>
true

Zoom avec pinch (appareils tactiles uniquement). Par défaut True

dblClickDragZoom boolean <optional>
true

Zoom par double-clic + glisser. Par défaut True

hover boolean <optional>
false

Démarre l'api de survol de feature automatiquement

zoomVisible boolean <optional>
true

Affiche le contrôle de zoom dans la barre verticale

zoomSliderVisible boolean <optional>
false

Affiche un slider de zoom dans la barre verticale

zoomRectangle boolean <optional>
false

Affiche un bouton de zoom rectangle dans la barre verticale

rotateControl boolean <optional>
true

Affiche un bouton de retour au nord dans la barre verticale

exportControl boolean <optional>
false

affichage du bouton d'export de la carte

copyMapControl boolean <optional>
false

affichage du bouton de copie dans le presse papier

isDesktop boolean <optional>
false

viewer en mode desktop, impacte les outils de dessin

zoomOrigin ol.coordinate | function

Défini le zoom d'origine de la carte (bouton centrer la carte). Par défaut bouton non visible

zoomExtentLabel string

Contenu du bouton de zoom à l'origine de la carte

limitExtent ol.extent

Permet de définir un périmètre de déplacement autorisé sur la carte.

bufferNullExtent number

Permet de définir un buffer à appliquer sur les extents sans taille.

projections Array.<Object>

Enregistre ces projections en mémoire

projections[].name string

Nom de la projection (EPSG:4326)

projections[].projection string

Définition proj4 (exemple {@links https://epsg.io/27562})

scaleLineOptions object

options pour la scaleLine {@links https://openlayers.org/en/latest/apidoc/module-ol_control_ScaleLine-ScaleLine.html}

options.minScale number <nullable>

Echelle minimale d'affichage

options.maxScale number <nullable>

Echelle maximale d'affichage

options.verticalBarPosition null | 'top' | 'bottom' | 'right' | 'left' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' <optional>
'top-left'

position par défaut de la barre verticale

options.horizontalBarPosition null | 'top' | 'bottom' | 'right' | 'left' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' <optional>
'bottom'

position par défaut de la barre horizontale

Source:

Members


bufferNullExtent :number

Gestion d'un buffer sur le zoom d'une extent sans taille

.

Gestion d'un buffer sur le zoom d'une extent sans taille

Type:
  • number
Source:

featureSnapper :FeatureSnapper

Type:
Source:

hitTolerance :number

tolerance au clic pour les outils de sélection

.

tolerance au clic pour les outils de sélection

Type:
  • number
Source:

hitTolerance

Paramètres a garder en mémoire

.

Paramètres a garder en mémoire

Source:

horizontalToolbar :ControlBar

Type:
Source:

isDesktop :boolean

mode desktop du viewer

.

mode desktop du viewer

Type:
  • boolean
Source:

layerFilterInteraction

Source:

Map :ol.Map

Type:
  • ol.Map
Source:

padding :Array.<number>

gestion du padding au niveau applicatif entier (permet a l'application de se "décentrer")

.

gestion du padding au niveau applicatif entier (permet a l'application de se "décentrer")

Type:
  • Array.<number>
Source:

printControl :CustomPrint

Type:
  • CustomPrint
Source:

tokenManagerPool :TokenManagerPool

Type:
  • TokenManagerPool
Source:

verticalToolbar :ControlBar

Type:
Source:

zoomIn

Zoom d'un niveau

.

Zoom d'un niveau

Source:

zoomOrigin :function|ol.Coordinate

Extent de l'origine de la carte (peut-être une fonction), utilisé dans ControlBar

.

Extent de l'origine de la carte (peut-être une fonction), utilisé dans ControlBar

Type:
  • function | ol.Coordinate
Source:

zoomOut

Dezoom d'un niveau

.

Dezoom d'un niveau

Source:

Methods


addSearchControl(options)

Parameters:
Name Type Description
options Object

Options de création du contrôle de recherche

Properties
Name Type Argument Default Description
provider 'ban' | 'photon' | 'wfs' <optional>
ban

Nom du fournisseur pour la recherche

reverse boolean <optional>
false

Affiche un outil de géocodage inverse d'adresse

reverseTitle string <optional>
Cliquer sur la carte...

Titre à afficher sur le tooltip du bouton de géocodage inverse

position boolean <optional>
true

Priorise les résultats près du centre de la carte affichée

label string <optional>
Rechercher

Libellé affiché pour la zone de recherche

placeholder string <optional>
Rechercher une adresse

Placeholder de la zone de recherche

maxItems integer <optional>
10

Nombre de résultats affichés classés par score

limit integer <optional>
10

Nombre de résultats recherchés (utile lorsque l'on va appliquer un filtre)

typing number <optional>
500

le délais en ms pour lancer la recherche après une saisie utilisateur

minLength integer <optional>
3

la longueur de la chaine de recherche à partir de laquelle lancer la recherche

resultZoom integer <optional>
16

Zoom minimal à appliquer lors de la localisation sur la carte d'un résultat

citycodes Array.<string> <optional>
[]

Liste de code insee sur lesquels on va lancer la recherche (attention, une requête sera réalisée par code insee)

postfilters Array.<PostFilter> <optional>
[]

Liste des filtres à appliquer sur les résultats (attention, il est possible qu'aucun résultat ne s'affiche)

wfsSources Array.<WfsSource> <optional>
[]

Options de recherche pour le type wfs en cascade (dans l'ordre du tableau)

Properties:
Name Type Argument Description
type 'citycode' | 'postalcode' | 'city' | 'context'

type de filtre (seul les types 'citycode' et 'postalcode' sont pris en charge)

values Array.<(string|number)>

liste des valeurs que l'on accepte

Paramètre de recherche WfsSource

name String

type de filtre

wfs Object

Paramère générale de la source

Properties
Name Type Argument Default Description
url string

Url du service

version string <optional>
<nullable>
1.0.0

version du service

featureNS string

Namespace (a retrouver avec getCapabilities)

featurePrefix string

prefix de la source a interroger

featureTypes Array.<string>

// liste des couches a interroger

searchIn Array.<string>

// recherche ce que l'utilisateur va taper dans ces champs

prefilter Object

préfiltrage sur une des propriétée

Properties
Name Type Description
key string | Array

Nom du champ que l'on préfiltre, on peut utiliser une valeur, une liste de valeur ou un mot clé pour utiliser un résultat précédent (code_dep: "94" ou code_insee: ['94041','94081','94046','94002'] ou code_dep: 'PREVIOUS_RESULT.commune.code_dep' ou code_com: 'PREVIOUS_RESULT.commune.<%= code_insee.slice(2) %>')

value string | Array

nom du champ ou des champs a retourner (pour utiliser dans la cascade)

display string

libellé a afficher dans la liste

placeholder string <nullable>

surcharge du placeholder de la zone de recherche pour cette étape

geometryName string <nullable>

nom de la propriété géométrie (utilisé pour filtre bbox ou lors du zoom vers une feature)

useBbox boolean <nullable>

tente d'utiliser la bbox du résultat fin le plus proche comme filtre, geometryName est nécessaire

minLength number <nullable>

surcharge du nombre de caractère minimum a taper pour cette étape

Permet d'ajouter un contrôle de recherche

Source:

addSourceToFeatureSnapper(snapSource)

Parameters:
Name Type Description
snapSource Object

paramétrage d'une snapSource

Properties
Name Type Argument Description
groups Array.<snapGroup> <optional>

groupes auquels appartientla source

source ol.source.Vector <optional>

Source openlayer, attention a ne pas ajouter des sources composée des même features...

Properties:
Name Type Description
name String

nom du groupe auquel appartient la source

edge Boolean

accrochage aux ligne

vertex Boolean

accrochage au extremités

Ajoute une source vecteur a surveiller

Source:

<async> addTokenSource(tokenOptions)

Ajoute une source de token

.

Ajoute une source de token

Parameters:
Name Type Description
tokenOptions tokenOptions | String

options de gestion du token ou token en clair (historique)

Source:
Returns:
Type
TokenManager

clearFeatureSnapper()

Supprime toutes les sources du featureSnapper

.

Supprime toutes les sources du featureSnapper

Source:

<async> copyMap(options)

Copie la carte dans le presse papier

.

Copie la carte dans le presse papier

Parameters:
Name Type Description
options Object
Properties
Name Type Default Description
imageType string

Format d'image, default image/png

quality number

Number between 0 and 1 indicating the image quality to use for image formats that use lossy compression such as image/jpeg and image/webp

orientation string

Orientation (paysage/portrait), default "devine le meilleur"

immediate boolean false

force l'impression même si la carte n'a pas finie de charger, default false

Source:

dispatchEvent(type, data)

Permet de lever un event

.

Permet de lever un event

Parameters:
Name Type Description
type String

Type d'event à lever

data *

Données à transmettre

Source:

flyToExtent(extent, options)

Permet de zoomer sur une extent avec une animaion (1 seconde)

.

Permet de zoomer sur une extent avec une animaion (1 seconde)

Parameters:
Name Type Description
extent ol.Extent

The destination extent

options Object

Voir ol.View.fit

Source:

getCenter(options)

Permet de récupérer le centre de la vue.

Permet de récupérer le centre de la vue. Possibilité de prendre en compte un padding.

Parameters:
Name Type Description
options Object

Options pour récupérer le centre de la carte

Properties
Name Type Description
padding Array.<number>

[right, top, bottom, left] Padding à appliquer si l'ensemble de la vue n'est pas visible par l'utilisateur

Source:
Returns:

Coordonnées du centre de la carte

Type
Array.<Number>

getExtent()

Permet de récupérer l'extent de la vue courrante

.

Permet de récupérer l'extent de la vue courrante

Source:

getFeatureSnapper()

Renvoit le featureSnapper

.

Renvoit le featureSnapper

Source:
Returns:
Type
FeatureSnapper

getFlatLayers(layers)

renvoi les calques et ceux dans les groupe (un groupe est considéré par un layer par Map.getLayers)

.

renvoi les calques et ceux dans les groupe (un groupe est considéré par un layer par Map.getLayers)

Parameters:
Name Type Description
layers Array

mets a place cette liste, part de map.getLayers() si vide

Source:
Returns:

la liste des calques à plat


getMap()

Renvoi la carte

.

Renvoi la carte

Source:
Returns:
Type
ol.Map

<async> getMapSnapshot(options)

Renvoit une promesse avec le screenshot de la carte

.

Renvoit une promesse avec le screenshot de la carte

Parameters:
Name Type Description
options Object
Properties
Name Type Default Description
imageType string

Format d'image, default image/png

quality number

Number between 0 and 1 indicating the image quality to use for image formats that use lossy compression such as image/jpeg and image/webp

orientation string

Orientation (paysage/portrait), default "devine le meilleur"

immediate boolean false

force l'impression même si la carte n'a pas finie de charger, default false

toDataUrl boolean false

retour sous forme de "data url", default false

Source:
Returns:

Blob ou dataUrl de l'image de la carte

Type
Promise.<Blob> | Promise.<string>

getResolution()

Permet de récupérer la résolution actuelle de la carte

.

Permet de récupérer la résolution actuelle de la carte

Source:
Returns:

Résolution de la carte

Type
Number

getRotation()

Permet de récupérer la rotation en radian de la carte

.

Permet de récupérer la rotation en radian de la carte

Source:
Returns:

Rotation de la carte en radian

Type
Number

getScale( [round])

renvoi l'échelle d'affichage courante

.

renvoi l'échelle d'affichage courante

Parameters:
Name Type Argument Default Description
round boolean <optional>
<nullable>
false

arrondir?

Source:
Returns:

Number


getViewProjection()

Renvoi le code de projection actuel de la carte

.

Renvoi le code de projection actuel de la carte

Source:
Returns:

Code de projection

Type
string

getZoom()

Récupère le niveau de zoom actuel

.

Récupère le niveau de zoom actuel

Source:

isFeatureInMapExtent(feature)

Permet de savoir si une feature est visible dans la vue courrante

.

Permet de savoir si une feature est visible dans la vue courrante

Parameters:
Name Type Description
feature ol.Feature

Feature à tester

Source:

on(type, listener, context)

Permet d'ecouter un event

.

Permet d'ecouter un event

Parameters:
Name Type Description
type String

Type d'event à écouter

listener function

Callback losque l'event survient

context Object

Context d'appel du callback

Source:

once(type, listener, context)

Permet d'ecouter un event une seule fois

.

Permet d'ecouter un event une seule fois

Parameters:
Name Type Description
type String

Type d'event à écouter

listener function

Callback losque l'event survient

context Object

Context d'appel du callback

Source:

<async> print(options)

télécharge une copie de la carte

.

télécharge une copie de la carte

Parameters:
Name Type Description
options Object
Properties
Name Type Default Description
imageType string

Format d'image, default image/png

quality number

Number between 0 and 1 indicating the image quality to use for image formats that use lossy compression such as image/jpeg and image/webp

orientation string

Orientation (paysage/portrait), default "devine le meilleur"

immediate boolean false

force l'impression même si la carte n'a pas finie de charger, default false

filename string

Nom de fichier

Source:
Returns:

Blob de l'image de la carte

Type
Promise.<Blob>

refreshMap()

Permet de recalculer l'ensemble des layers

.

Permet de recalculer l'ensemble des layers

Source:

removeSourceToken(tokenOptions)

Supprime une source de token

.

Supprime une source de token

Parameters:
Name Type Description
tokenOptions tokenOptions | String

options de gestion du token ou token en clair (historique)

Source:
Returns:

true si le token a été supprimé

Type
Boolean

setCenter(center, options)

Permet de changer le centre de la vue.

Permet de changer le centre de la vue. Possibilité de prendre en compte un padding.

Parameters:
Name Type Description
center Array.<Number>

Nouveau centre de la carte à appliquer

options Object

Options pour modifier le centre de la carte

Properties
Name Type Description
padding Array.<number>

[top, right, bottom, left] Padding à appliquer si l'ensemble de la vue n'est pas visible par l'utilisateur

Source:

setFeatureHover(options)

Démarre ou remplace le service de survol des features

.

Démarre ou remplace le service de survol des features

Parameters:
Name Type Description
options Object
Source:

setFeatureHoverActive(active)

Met en pause ou active le service survol des features

.

Met en pause ou active le service survol des features

Parameters:
Name Type Description
active Boolean
Source:

setLimitExtent(extent, center, buffer)

Permet de définir un extent comme limite de déplacement sur la carte

.

Permet de définir un extent comme limite de déplacement sur la carte

Parameters:
Name Type Description
extent ol.extent

Extent à appliquer (dans l'epsg de la carte)

center Boolean

Place la carte au centre de l'extent. Par défaut false

buffer number

Ratio du buffer à appliquer à l'extent. Par défaut 1 (extent original)

Source:

setResolution(resolution)

Permet de modifier la résolution actuelle de la carte

.

Permet de modifier la résolution actuelle de la carte

Parameters:
Name Type Description
resolution Number

Résolution de la carte

Source:

setRotation(rotation, options)

Permet de modifier la rotation de la carte

.

Permet de modifier la rotation de la carte

Parameters:
Name Type Description
rotation Number

Rotation de la carte en radian

options Object

Options pour la rotation de la carte

Properties
Name Type Description
padding Array.<Number>

Padding à prendre en compte pour la rotation [top, right, bottom, left]

Source:

setScale(scale, animate)

Met la carte a l'echelle demandée

.

Met la carte a l'echelle demandée

Parameters:
Name Type Description
scale Number

echelle a atteindre

animate boolean | object | null

Animer la mise a l'echelle (true: animation prédéfinie, object: options compatible https://openlayers.org/en/latest/apidoc/module-ol_View-View.html#animate)

Source:

setViewProjection(toProjection)

Verifi que la vue est dans la même projection que celle demandée et switch la projection

.

Verifi que la vue est dans la même projection que celle demandée et switch la projection

Parameters:
Name Type Description
toProjection String
Source:
Returns:

projection changed

Type
Boolean

setZoom(zoom)

set le niveau de zoom actuel

.

set le niveau de zoom actuel

Parameters:
Name Type Description
zoom Number

niveau de zoom, plus c'est élevè, plus on se rapproche

Source:

<async> startMeasure(measureType)

Lance le mode mesure

.

Lance le mode mesure

Parameters:
Name Type Description
measureType 'distance' | 'area'

type de mesure a effectuer

Source:
Returns:

MapMeasureEvent


startRecordingTrace(options)

Démarre l'enregistrement

.

Démarre l'enregistrement

Parameters:
Name Type Description
options Object
Properties
Name Type Description
interval Boolean

interval d'enregistrement des points

precision Number

Nombre de chiffres après la virgule

horodatage Number

interval d'enregistrement des points

Source:

stopRecordingTrace()

Annule l'enregistrement de trace

.

Annule l'enregistrement de trace

Source:

un(type, listener, context)

Permet de ne plus ecouter un event

.

Permet de ne plus ecouter un event

Parameters:
Name Type Description
type String

Type d'event à écouter

listener function

Callback losque l'event survient

context Object

Context d'appel du callback

Source:

validateRecordingTrace(options)

Validation, lance l'event, renvoit le résultat et retirer le controle

.

Validation, lance l'event, renvoit le résultat et retirer le controle

Parameters:
Name Type Description
options Object
Properties
Name Type Description
silent Boolean

ne lance pas l'event

Source:
Returns:

{positions, feature}

Type
object

zoomToExtent(extent, options)

Permet de zoomer sur une extent

.

Permet de zoomer sur une extent

Parameters:
Name Type Description
extent ol.Extent

Extent sur laquelle zoomer

options Object

Voir ol.View.fit

Source: