Ajout de la jsdoc pour le service de configuration

src/Services/Config/ConfigInterface.js

@@ -139,6 +139,7 @@ ConfigInterface.prototype = {
      *
      * @param {String} layerId - Geoportal layer identifier (e.g. "GEOGRAPHICALGRIDSYSTEMS.MAPS$GEOPORTAIL:OGC:WMTS")
      * @return {Object} layer - Layer configuration
+     * @see Gp.Services.Config.Layer
      */
     getLayerConf : function (layerId) {
         if (!this.layers) {
@@ -281,6 +282,7 @@ ConfigInterface.prototype = {
      *
      * @param {String} tmsID - Tile Matrix Set identifier (e.g. : "PM")
      * @return {Object} tileMatrixSet - Tile Matrix Set configuration
+     * @see Gp.Services.Config.TileMatrixSet
      */
     getTMSConf : function (tmsID) {
         if (!this.tileMatrixSets) {

src/Services/Config/model/Constraint.js

@@ -0,0 +1,16 @@
+
+/**
+ *
+ * Object used to express a geographical (BBOX, scale) and temporal constraint.
+ *
+ * @property {String} crs - Coordinates System ID used to express coordinates contraints.
+ * @property {Gp.BBox} bbox - Constraint Bounding Box.
+ * @property {Number} minScaleDenominator - Minimum scale denominator where constraint applies.
+ * @property {Number} maxScaleDenominator - Maximum scale denominator where constraint applies.
+ * @property {Array.<String>} temporalExtent - Array expressing the time interval of the constraint [minT, maxT]. Dates are expressed in the [ISO-8601]{@link https://en.wikipedia.org/wiki/ISO_8601} way.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Constraint
+ */
+
+var Constraint = {};

src/Services/Config/model/Format.js

@@ -0,0 +1,12 @@
+
+/**
+ * Object used to describe a format to use with Geoportal resources.
+ *
+ * @property {Boolean} current - If true, then this format is used by default.
+ * @property {String} name - Format mime-type.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Format
+ */
+
+var Format = {};

src/Services/Config/model/Layer.js

@@ -0,0 +1,41 @@
+/**
+ * Object used to describe geoportal resource (WMTS, WMS, WFS layers, geocoding resources or elevation service) parameters. Properties may be used or not depending on the resource type.
+ *
+ * @property {String} name - name of the resource to use with the webservice that serves it (eg : "GEOGRAPHICALGRIDSYSTEMS.MAPS").
+ * @property {String} title - Human readable name for the resource.
+ * @property {String} description - Resource description.
+ * @property {String} layerId - Unique resource Identifier (eg : "GEOGRAPHICALGRIDSYSTEMS.MAPS$GEOPORTAIL:OGC:WMTS")
+ * @property {String} quicklookUrl - Image URL for the resource.
+ * @property {Object} serviceParams - Informations about the webservice that serves the resource (OpenLS, WFS, WMTS)
+ * @property {String} serviceParams.id - Web Service identifier ("OGC:WMTS", "OGC:OPENLS;ReverseGeocode", etc...)
+ * @property {Object} serviceParams.serverUrl - Associative array mapping geoportal access key (keys) with their properties (URLs of the web service, with the geoportal access key).
+ * @property {String} serviceParams.version - webservice version.
+ * @property {String} defaultProjection - coordinates system ID used by default for the resource (WMS or WFS layer) or of the TileMatrixSet used by the WMTS layer.
+ * @property {Array.<String>} additionalProjections - additional coordinates systems IDs availables for the resource, others than the default one (see defaultProjection) (WMS and WFS layers only).
+ * @property {Array.<Gp.Services.Config.Format>} formats - Formats availables for the resource.
+ * @property {Array.<Gp.Services.Config.Legend>} legends - Informations about legends associated to the resource.
+ * @property {Array.<Gp.Services.Config.Metadata>} metadata - Informations about metadata associated to the resource.
+ * @property {Array.<Gp.Services.Config.Style>} styles - Informations about styles availables for the resources (WMS, WFS and WMTS only).
+ * @property {Array.<Gp.Services.Config.Thematic>} thematics - Informations about thematics associated to the resource.
+ * @property {Gp.Services.Config.Constraint} globalConstraint - geographical constraint for the resource.
+ * @property {Array.<Gp.Services.Config.Constraint>} constraints - additionnal geographical constraints for the resource.
+ * @property {Array.<Gp.Services.Config.Originator>} originators - Informations about originator of the resource.
+ * @property {Object} wmtsOptions - Informations associated to WMTS resources.
+ * @property {String} wmtsOptions.tileMatrixSetLink - TileMatrixSet identifier used by the resource (see {@link Gp.Services.Config.TileMatrixSet})
+ * @property {Gp.Services.Config.TileMatrixLimit} wmtsOptions.tileMatrixSetLimits - limits of the resource for that TileMAtrixSet.
+ * @property {Boolean} queryable - true if a getFeatureInfo request may be done for the resource (WMS or WMTS only).
+ * @property {Boolean} hidden - true if the resource is not visible.
+ * @property {Boolean} isAggregate - true if the resource is an aggregate of other resources (@see aggregatedLayers).
+ * @property {Array.<String>} aggregatedLayers - Layers IDs composing the being described aggregated layer.
+ * @property {Array.<String>} apiKeys - Array of access keys that grant access to that resource.
+ * @property {Object} dimensions - Dimensions informations associated with the resource.
+ * @property {String} dimensions.type
+ * @property {String} dimensions.visibilityRange
+ * @property {String} dimensions.visibilityMode
+ * @property {String} dimensions.noDataValue
+ * @property {String} dimensions.geometricType
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Layer
+ */
+var Layer = {};

src/Services/Config/model/Legend.js

@@ -0,0 +1,13 @@
+
+/**
+ * Object used to describe a legend file associated with a geoportal resource (WMTS, WMS, WFS layers).
+ *
+ * @property {String} format - mime-type of the legend file.
+ * @property {String} url - legend file URL
+ * @property {Number} minScaleDenominator - minimum scale denominator where this legend applies.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Legend
+ */
+
+var Legend = {};

src/Services/Config/model/Metadata.js

@@ -0,0 +1,12 @@
+
+/**
+ * Object used to describe a metadata file associated with a geoportal resource.
+ *
+ * @property {String} format - mime-type of the metadata file.
+ * @property {String} url - metadata file URL
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Metadata
+ */
+
+var Metadata = {};

src/Services/Config/model/Originator.js

@@ -0,0 +1,15 @@
+
+/**
+ * Object used to describe an Originator of geoportal resource.
+ *
+ * @property {String} name - originator name
+ * @property {String} attribution - originator full name
+ * @property {String} logo - originator logo file URL
+ * @property {String} url - originator web site URL
+ * @property {Array.<Gp.Services.Config.Constraint>} constraints - where and when the originator applies for the ressource.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Originator
+ */
+
+var Originator = {};

src/Services/Config/model/Service.js

@@ -0,0 +1,12 @@
+
+/**
+ * Object used to describe a web service of the geoportal platform.
+ *
+ * @property {String} title - Web service name
+ * @property {Object} serverUrl - Associative array mapping geoportal access key (keys) with their properties (URLs of the web service, with the geoportal access key).
+ * @property {String} version - web service version.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Service
+ */
+var Service = {};

src/Services/Config/model/Style.js

@@ -0,0 +1,14 @@
+
+/**
+ * Object used to describe a style that may be used for a geoportal resource.
+ *
+ * @property {String} name - Style identifier (eg : "normal", "bdparcellaire", ...)
+ * @property {String} title - human readable name of the style.
+ * @property {Boolean} current - true if this is the default style.
+ * @property {String} url - Url Style (eg: vectortile).
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Style
+ */
+
+var Style = {};

src/Services/Config/model/Territory.js

@@ -0,0 +1,21 @@
+
+/**
+ * Object used to describe properties of a french territory covered by geoportal resources.
+ *
+ * @property {Boolean} isDefault - if this territory is to use by default.
+ * @property {String} defaultCRS - Identifier of the coordinates system to use by default for that territory.
+ * @property {Array.<String>} additionalCRS - Identifiers of additional coordinates systems availables for that territory.
+ * @property {Array.<String>} defaultLayers - Identifiers of layers to load by default for that territory.
+ * @property {Object} defaultOptions - options to use by default for that territory.
+ * @property {Number} defaultOptions.resolution - resolution to use by default for that territory (in meter per pixel).
+ * @property {Number} defaultOptions.minScaleDenominator - minimum scaleDenominator accessible for that territory.
+ * @property {Number} defaultOptions.maxScaleDenominator - maximum scaleDenominator accessible for that territory.
+ * @property {Gp.BBox} geoBBox - Bounding Box of the territory (expressed in geographical coordinates)
+ * @property {Object} geoCenter - center of the territory (expressed in geographical coordinates)
+ * @property {Float} geoCenter.lon - center longitude
+ * @property {Float} geoCenter.lat - center latitude
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Territory
+ */
+var Territory = {};

src/Services/Config/model/Thematic.js

@@ -0,0 +1,12 @@
+
+/**
+ * Object used to describe a thematic
+ *
+ * @property {String} name - Thematic name
+ * @property {Boolean} inspire - true if the thematic name is an [INSPIRE one]{@link http://inspire.ec.europa.eu/index.cfm/pageid/2/list/7}.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.Thematic
+ */
+
+var Thematic = {};

src/Services/Config/model/TileMatrix.js

@@ -0,0 +1,17 @@
+
+/**
+ * Object used to describe a TileMatrix.
+ *
+ * @property {String} matrixId - matrix Identifier
+ * @property {Number} matrixHeight - Number of tiles from the top to the bottom of the matrix.
+ * @property {Number} matrixWidth - Number of tiles from the left to the right of the matrix.
+ * @property {Number} scaleDenominator - Scale denominator associated to that matrix.
+ * @property {Number} tileHeight - tile height in number of pixels
+ * @property {Number} tileWidth - tile width in number of pixels
+ * @property {Gp.Point} topLeftCorner - Top Left Corner Point of the matrix expressed in the tileMatrixSet coordinates system.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.TileMatrix
+ */
+
+var TileMatrix = {};

src/Services/Config/model/TileMatrixLimit.js

@@ -0,0 +1,14 @@
+
+/**
+ * Object used to describe a layer extent on a Tile Matrix.
+ *
+ * @property {Number} minTileCol - minimum column index where tile can be found on the Tile matrix.
+ * @property {Number} maxTileCol - maximum column index where tile can be found on the Tile matrix.
+ * @property {Number} minTileRow - minimum row index where tile can be found on the Tile matrix.
+ * @property {Number} maxTileCol - maximum row index where tile can be found on the Tile matrix.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.TileMatrixLimit
+ */
+
+var TileMatrixLimit = {};

src/Services/Config/model/TileMatrixSet.js

@@ -0,0 +1,14 @@
+
+/**
+ *
+ * Object used to describe a TileMatrix set (for WMTS use).
+ *
+ * @property {Array.<String>} matrixIds - Array of IDs for each TileMatrix of the set.
+ * @property {Array.<Gp.Services.Config.TileMatrix>} tileMatrices - Array of TileMatrix descriptions.
+ * @property {Array.<Float>} nativeResolutions - Array of resolutions (in meter per pixel) applying for each TileMatrix of the set.
+ * @property {String} projection - Identifier of the Cordinates System used for the tileMatrixSet.
+ *
+ * @namespace
+ * @alias Gp.Services.Config.TileMatrixSet
+ */
+var TileMatrixSet = {};