github.com/PDOK/gokoala@v0.50.6/internal/engine/testdata/ogcapi-merged.json (about) 1 { 2 "components": { 3 "parameters": { 4 "bbox": { 5 "description": "Only features that have a geometry that intersects the bounding box are selected.\nThe bounding box is provided as four or six numbers, depending on whether the\ncoordinate reference system includes a vertical axis (height or depth):\n\n* Lower left corner, coordinate axis 1\n* Lower left corner, coordinate axis 2\n* Minimum value, coordinate axis 3 (optional)\n* Upper right corner, coordinate axis 1\n* Upper right corner, coordinate axis 2\n* Maximum value, coordinate axis 3 (optional)\n\nIf the value consists of four numbers, the coordinate reference system is\nWGS 84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84)\nunless a different coordinate reference system is specified in the parameter `bbox-crs`.\n\nIf the value consists of six numbers, the coordinate reference system is WGS 84\nlongitude/latitude/ellipsoidal height (http://www.opengis.net/def/crs/OGC/0/CRS84h)\nunless a different coordinate reference system is specified in the parameter `bbox-crs`.\n\nThe query parameter `bbox-crs` is specified in OGC API - Features - Part 2: Coordinate\nReference Systems by Reference.\n\nFor WGS 84 longitude/latitude the values are in most cases the sequence of\nminimum longitude, minimum latitude, maximum longitude and maximum latitude.\nHowever, in cases where the box spans the antimeridian the first value\n(west-most box edge) is larger than the third value (east-most box edge).\n\nIf the vertical axis is included, the third and the sixth number are\nthe bottom and the top of the 3-dimensional bounding box.\n\nIf a feature has multiple spatial geometry properties, it is the decision of the\nserver whether only a single spatial geometry property is used to determine\nthe extent or all relevant geometries.", 6 "explode": false, 7 "in": "query", 8 "name": "bbox", 9 "required": false, 10 "schema": { 11 "items": { 12 "type": "number" 13 }, 14 "type": "array" 15 }, 16 "style": "form" 17 }, 18 "bgcolor": { 19 "description": "Web color name or hexadecimal 0x[AA]RRGGBB color value for the background color (default to 0x9C9C9C gray). If alpha is not specified, full opacity is assumed.", 20 "explode": false, 21 "in": "query", 22 "name": "bgcolor", 23 "required": false, 24 "schema": { 25 "default": "0xFFFFFF", 26 "type": "string" 27 }, 28 "style": "form" 29 }, 30 "collectionId": { 31 "description": "local identifier of a collection", 32 "explode": false, 33 "in": "path", 34 "name": "collectionId", 35 "required": true, 36 "schema": { 37 "type": "string" 38 }, 39 "style": "simple" 40 }, 41 "collectionId-all": { 42 "description": "Local identifier of a collection", 43 "in": "path", 44 "name": "collectionId", 45 "required": true, 46 "schema": { 47 "$ref": "#/components/schemas/all-collections" 48 } 49 }, 50 "collectionId-coverage": { 51 "allowEmptyValue": false, 52 "description": "Local identifier of a coverage collection", 53 "explode": false, 54 "in": "path", 55 "name": "collectionId", 56 "required": true, 57 "schema": { 58 "$ref": "#/components/schemas/coverage-collections" 59 }, 60 "style": "simple" 61 }, 62 "collectionId-vectorTiles": { 63 "allowEmptyValue": false, 64 "description": "Local identifier of a vector tile collection", 65 "in": "path", 66 "name": "collectionId", 67 "required": true, 68 "schema": { 69 "$ref": "#/components/schemas/vectorTiles-collections" 70 } 71 }, 72 "collections": { 73 "description": "The collections that should be included in the response. The parameter value is a comma-separated list of collection identifiers. If the parameters is missing, some or all collections will be included. The collection will be rendered in the order specified, with the last one showing on top, unless the priority is overridden by styling rules.", 74 "explode": false, 75 "in": "query", 76 "name": "collections", 77 "required": false, 78 "schema": { 79 "items": { 80 "$ref": "#/components/schemas/all-collections" 81 }, 82 "type": "array" 83 }, 84 "style": "form" 85 }, 86 "collections-coverage": { 87 "description": "The collections that should be included in the response. The parameter value is a comma-separated list of collection identifiers. If the parameters is missing, some or all collections will be included. The collection will be rendered in the order specified, with the last one showing on top, unless the priority is overridden by styling rules.", 88 "explode": false, 89 "in": "query", 90 "name": "collections", 91 "required": false, 92 "schema": { 93 "items": { 94 "$ref": "#/components/schemas/coverage-collections" 95 }, 96 "type": "array" 97 }, 98 "style": "form" 99 }, 100 "collections-vectorTiles": { 101 "description": "The collections that should be included in the response. The parameter value is a comma-separated list of collection identifiers. If the parameters is missing, some or all collections will be included. The collection will be rendered in the order specified, with the last one showing on top, unless the priority is overridden by styling rules.", 102 "explode": false, 103 "in": "query", 104 "name": "collections", 105 "required": false, 106 "schema": { 107 "items": { 108 "$ref": "#/components/schemas/vectorTiles-collections" 109 }, 110 "type": "array" 111 }, 112 "style": "form" 113 }, 114 "crs": { 115 "description": "reproject the output to the given crs", 116 "explode": true, 117 "in": "query", 118 "name": "crs", 119 "required": false, 120 "schema": { 121 "type": "string" 122 }, 123 "style": "form" 124 }, 125 "datetime": { 126 "description": "Either a date-time or an interval. Date and time expressions adhere to RFC 3339.\nIntervals may be bounded or half-bounded (double-dots at start or end).\n\nExamples:\n\n* A date-time: \"2018-02-12T23:20:50Z\"\n* A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n* Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n\nOnly features that have a temporal property that intersects the value of\n`datetime` are selected.\n\nIf a feature has multiple temporal properties, it is the decision of the\nserver whether only a single temporal property is used to determine\nthe extent or all relevant temporal properties.", 127 "explode": false, 128 "in": "query", 129 "name": "datetime", 130 "required": false, 131 "schema": { 132 "type": "string" 133 }, 134 "style": "form" 135 }, 136 "f-coverageTile": { 137 "description": "The format of the coverage tile response (e.g. tiff). Accepted values are 'tiff' (GeoTIFF), 'netcdf', or 'png'.", 138 "explode": false, 139 "in": "query", 140 "name": "f", 141 "required": false, 142 "schema": { 143 "enum": [ 144 "tiff", 145 "netcdf", 146 "png" 147 ], 148 "type": "string" 149 }, 150 "style": "form" 151 }, 152 "f-mapTile": { 153 "description": "The format of the map tile response (e.g. png). Accepted values are 'png', 'jpg' or 'tiff' (GeoTIFF).", 154 "explode": false, 155 "in": "query", 156 "name": "f", 157 "required": false, 158 "schema": { 159 "enum": [ 160 "png", 161 "jpg", 162 "tiff" 163 ], 164 "type": "string" 165 }, 166 "style": "form" 167 }, 168 "f-metadata": { 169 "description": "The format of the response. If no value is provided, the accept header is used to determine the format. Accepted values are 'json' or 'html'.", 170 "explode": false, 171 "in": "query", 172 "name": "f", 173 "required": false, 174 "schema": { 175 "enum": [ 176 "json", 177 "html" 178 ], 179 "type": "string" 180 }, 181 "style": "form" 182 }, 183 "f-vectorTile": { 184 "description": "The format of the vector tile response (e.g. json). Accepted values are 'mvt' (Mapbox Vector Tiles) or 'json' (GeoJSON).", 185 "explode": false, 186 "in": "query", 187 "name": "f", 188 "required": false, 189 "schema": { 190 "enum": [ 191 "mvt", 192 "json" 193 ], 194 "type": "string" 195 }, 196 "style": "form" 197 }, 198 "featureId": { 199 "description": "local identifier of a feature", 200 "explode": false, 201 "in": "path", 202 "name": "featureId", 203 "required": true, 204 "schema": { 205 "type": "string" 206 }, 207 "style": "simple" 208 }, 209 "limit": { 210 "description": "The optional limit parameter limits the number of items that are presented in the response document.\n\nOnly items are counted that are on the first level of the collection in the response document.\nNested objects contained within the explicitly requested items shall not be counted.\n\nMinimum = 1. Maximum = 10000. Default = 10.", 211 "explode": false, 212 "in": "query", 213 "name": "limit", 214 "required": false, 215 "schema": { 216 "default": 10, 217 "maximum": 10000, 218 "minimum": 1, 219 "type": "integer" 220 }, 221 "style": "form" 222 }, 223 "styleId": { 224 "allowEmptyValue": false, 225 "description": "An identifier representing a specific style.", 226 "in": "path", 227 "name": "styleId", 228 "required": true, 229 "schema": { 230 "$ref": "#/components/schemas/styles" 231 } 232 }, 233 "styleId-collection": { 234 "allowEmptyValue": false, 235 "description": "An identifier representing a specific style.", 236 "in": "path", 237 "name": "styleId", 238 "required": true, 239 "schema": { 240 "type": "string" 241 } 242 }, 243 "subset": { 244 "description": "Retrieve only part of the data by slicing or trimming along one or more axis\nFor trimming: {axisAbbrev}({low}:{high}) (preserves dimensionality)\n An asterisk (`*`) can be used instead of {low} or {high} to indicate the minimum/maximum value.\nFor slicing: {axisAbbrev}({value}) (reduces dimensionality)\n", 245 "explode": false, 246 "in": "query", 247 "name": "subset", 248 "required": false, 249 "schema": { 250 "items": { 251 "type": "string" 252 }, 253 "type": "array" 254 }, 255 "style": "form" 256 }, 257 "subset-crs": { 258 "description": "crs for the specified subset", 259 "explode": true, 260 "in": "query", 261 "name": "subset-crs", 262 "required": false, 263 "schema": { 264 "type": "string" 265 }, 266 "style": "form" 267 }, 268 "tileCol": { 269 "description": "Column index of the tile on the selected TileMatrix. It cannot exceed the MatrixHeight-1 for the selected TileMatrix. For example, Ireland is fully within the Tile at WebMercatorQuad tileMatrix=5, tileRow=10 and tileCol=15.", 270 "example": 15, 271 "in": "path", 272 "name": "tileCol", 273 "required": true, 274 "schema": { 275 "minimum": 0, 276 "type": "integer" 277 } 278 }, 279 "tileMatrix": { 280 "description": "Identifier selecting one of the scales defined in the TileMatrixSet and representing the scaleDenominator the tile. For example,\nIreland is fully within the Tile at WebMercatorQuad tileMatrix=5, tileRow=10 and tileCol=15.", 281 "example": "5", 282 "in": "path", 283 "name": "tileMatrix", 284 "required": true, 285 "schema": { 286 "type": "string" 287 } 288 }, 289 "tileMatrixSetId": { 290 "allowEmptyValue": false, 291 "description": "Identifier for a supported TileMatrixSet", 292 "in": "path", 293 "name": "tileMatrixSetId", 294 "required": true, 295 "schema": { 296 "$ref": "#/components/schemas/tileMatrixSets" 297 } 298 }, 299 "tileRow": { 300 "description": "Row index of the tile on the selected TileMatrix. It cannot exceed the MatrixWidth-1 for the selected TileMatrix. For example, Ireland is fully within the Tile at WebMercatorQuad tileMatrix=5, tileRow=10 and tileCol=15.", 301 "example": 10, 302 "in": "path", 303 "name": "tileRow", 304 "required": true, 305 "schema": { 306 "minimum": 0, 307 "type": "integer" 308 } 309 }, 310 "transparent": { 311 "description": "Background transparency of map (default=true).", 312 "explode": false, 313 "in": "query", 314 "name": "transparent", 315 "required": false, 316 "schema": { 317 "default": true, 318 "type": "boolean" 319 }, 320 "style": "form" 321 } 322 }, 323 "responses": { 324 "API": { 325 "content": { 326 "application/vnd.oai.openapi+json;version=3.0": { 327 "schema": { 328 "type": "object" 329 } 330 }, 331 "text/html": { 332 "schema": { 333 "type": "string" 334 } 335 } 336 }, 337 "description": "The OpenAPI definition of the API." 338 }, 339 "Collection": { 340 "content": { 341 "application/json": { 342 "example": { 343 "description": "Buildings in the city of Bonn.", 344 "extent": { 345 "spatial": { 346 "bbox": [ 347 [ 348 7.01, 349 50.63, 350 7.22, 351 50.78 352 ] 353 ] 354 }, 355 "temporal": { 356 "interval": [ 357 [ 358 "2010-02-15T12:34:56Z", 359 null 360 ] 361 ] 362 } 363 }, 364 "id": "buildings", 365 "links": [ 366 { 367 "href": "http://data.example.org/collections/buildings/items", 368 "rel": "items", 369 "title": "Buildings", 370 "type": "application/geo+json" 371 }, 372 { 373 "href": "http://data.example.org/collections/buildings/items.html", 374 "rel": "items", 375 "title": "Buildings", 376 "type": "text/html" 377 }, 378 { 379 "href": "https://creativecommons.org/publicdomain/zero/1.0/", 380 "rel": "license", 381 "title": "CC0-1.0", 382 "type": "text/html" 383 }, 384 { 385 "href": "https://creativecommons.org/publicdomain/zero/1.0/rdf", 386 "rel": "license", 387 "title": "CC0-1.0", 388 "type": "application/rdf+xml" 389 } 390 ], 391 "title": "Buildings" 392 }, 393 "schema": { 394 "$ref": "#/components/schemas/collection" 395 } 396 }, 397 "text/html": { 398 "schema": { 399 "type": "string" 400 } 401 } 402 }, 403 "description": "Information about the feature collection with id `collectionId`.\n\nThe response contains a link to the items in the collection\n(path `/collections/{collectionId}/items`, link relation `items`)\nas well as key information about the collection. This information\nincludes:\n\n* A local identifier for the collection that is unique for the dataset;\n* A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);\n* An optional title and description for the collection;\n* An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data;\n* An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature')." 404 }, 405 "Collections": { 406 "content": { 407 "application/json": { 408 "example": { 409 "collections": [ 410 { 411 "description": "Buildings in the city of Bonn.", 412 "extent": { 413 "spatial": { 414 "bbox": [ 415 [ 416 7.01, 417 50.63, 418 7.22, 419 50.78 420 ] 421 ] 422 }, 423 "temporal": { 424 "interval": [ 425 [ 426 "2010-02-15T12:34:56Z", 427 null 428 ] 429 ] 430 } 431 }, 432 "id": "buildings", 433 "links": [ 434 { 435 "href": "http://data.example.org/collections/buildings/items", 436 "rel": "items", 437 "title": "Buildings", 438 "type": "application/geo+json" 439 }, 440 { 441 "href": "http://data.example.org/collections/buildings/items.html", 442 "rel": "items", 443 "title": "Buildings", 444 "type": "text/html" 445 }, 446 { 447 "href": "https://creativecommons.org/publicdomain/zero/1.0/", 448 "rel": "license", 449 "title": "CC0-1.0", 450 "type": "text/html" 451 }, 452 { 453 "href": "https://creativecommons.org/publicdomain/zero/1.0/rdf", 454 "rel": "license", 455 "title": "CC0-1.0", 456 "type": "application/rdf+xml" 457 } 458 ], 459 "title": "Buildings" 460 } 461 ], 462 "links": [ 463 { 464 "href": "http://data.example.org/collections.json", 465 "rel": "self", 466 "title": "this document", 467 "type": "application/json" 468 }, 469 { 470 "href": "http://data.example.org/collections.html", 471 "rel": "alternate", 472 "title": "this document as HTML", 473 "type": "text/html" 474 }, 475 { 476 "href": "http://schemas.example.org/1.0/buildings.xsd", 477 "rel": "describedby", 478 "title": "GML application schema for Acme Corporation building data", 479 "type": "application/xml" 480 }, 481 { 482 "href": "http://download.example.org/buildings.gpkg", 483 "length": 472546, 484 "rel": "enclosure", 485 "title": "Bulk download (GeoPackage)", 486 "type": "application/geopackage+sqlite3" 487 } 488 ] 489 }, 490 "schema": { 491 "$ref": "#/components/schemas/collections" 492 } 493 }, 494 "text/html": { 495 "schema": { 496 "type": "string" 497 } 498 } 499 }, 500 "description": "The feature collections shared by this API.\n\nThe dataset is organized as one or more feature collections. This resource\nprovides information about and access to the collections.\n\nThe response contains the list of collections. For each collection, a link\nto the items in the collection (path `/collections/{collectionId}/items`,\nlink relation `items`) as well as key information about the collection.\nThis information includes:\n\n* A local identifier for the collection that is unique for the dataset;\n* A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);\n* An optional title and description for the collection;\n* An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data;\n* An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature')." 501 }, 502 "CollectionsList": { 503 "content": { 504 "application/json": { 505 "example": { 506 "collections": [ 507 { 508 "description": "Buildings in the city of Bonn.", 509 "extent": { 510 "spatial": { 511 "bbox": [ 512 [ 513 7.01, 514 50.63, 515 7.22, 516 50.78 517 ] 518 ] 519 }, 520 "temporal": { 521 "interval": [ 522 [ 523 "2010-02-15T12:34:56Z", 524 null 525 ] 526 ] 527 } 528 }, 529 "id": "buildings", 530 "links": [ 531 { 532 "href": "http://data.example.org/collections/buildings/items", 533 "rel": "items", 534 "title": "Buildings", 535 "type": "application/geo+json" 536 }, 537 { 538 "href": "http://data.example.org/collections/buildings/items.html", 539 "rel": "items", 540 "title": "Buildings", 541 "type": "text/html" 542 }, 543 { 544 "href": "https://creativecommons.org/publicdomain/zero/1.0/", 545 "rel": "license", 546 "title": "CC0-1.0", 547 "type": "text/html" 548 }, 549 { 550 "href": "https://creativecommons.org/publicdomain/zero/1.0/rdf", 551 "rel": "license", 552 "title": "CC0-1.0", 553 "type": "application/rdf+xml" 554 } 555 ], 556 "title": "Buildings" 557 } 558 ], 559 "links": [ 560 { 561 "href": "http://data.example.org/collections.json", 562 "rel": "self", 563 "title": "this document", 564 "type": "application/json" 565 }, 566 { 567 "href": "http://data.example.org/collections.html", 568 "rel": "alternate", 569 "title": "this document as HTML", 570 "type": "text/html" 571 }, 572 { 573 "href": "http://schemas.example.org/1.0/buildings.xsd", 574 "rel": "describedby", 575 "title": "GML application schema for Acme Corporation building data", 576 "type": "application/xml" 577 }, 578 { 579 "href": "http://download.example.org/buildings.gpkg", 580 "length": 472546, 581 "rel": "enclosure", 582 "title": "Bulk download (GeoPackage)", 583 "type": "application/geopackage+sqlite3" 584 } 585 ] 586 }, 587 "schema": { 588 "$ref": "#/components/schemas/collections" 589 } 590 }, 591 "text/html": { 592 "schema": { 593 "type": "string" 594 } 595 } 596 }, 597 "description": "The collections of (mostly geospatial) data available from this API. The dataset contains one or more collections. This resource provides information about and access to the collections. The response contains the list of collections. Each collection is accessible via one or more OGC API set of specifications, for which a link to relevant accessible resources, e.g. /collections/{collectionId}/(items, coverage, map, tiles...) is provided, with the corresponding relation type, as well as key information about the collection. This information includes:\n* a local identifier for the collection that is unique for the dataset;\n* a list of coordinate reference systems (CRS) in which data may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);\n* an optional title and description for the collection;\n* an optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data;\n* for collections accessible via the Features or Records API, an optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature')." 598 }, 599 "Conformance": { 600 "content": { 601 "application/json": { 602 "schema": { 603 "allOf": [ 604 { 605 "$ref": "#/components/schemas/confClasses" 606 } 607 ], 608 "example": { 609 "conformsTo": [ 610 "http://www.opengis.net/spec/ogcapi-common-1/1.0/conf/core", 611 "http://www.opengis.net/spec/ogcapi-common-1/1.0/conf/json", 612 "http://www.opengis.net/spec/ogcapi-common-1/1.0/conf/html", 613 "http://www.opengis.net/spec/ogcapi-common-1/1.0/conf/oas30", 614 "http://www.opengis.net/spec/ogcapi-common-2/1.0/conf/collections", 615 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core", 616 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset", 617 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tilesets-list", 618 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/geodata-tilesets", 619 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/dataset-tilesets", 620 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/geodata-selection", 621 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/jpeg", 622 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/png", 623 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/mvt", 624 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/geojson", 625 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tiff", 626 "http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/netcdf" 627 ] 628 } 629 } 630 } 631 }, 632 "description": "The URIs of all conformance classes supported by the server" 633 }, 634 "ConformanceDeclaration": { 635 "content": { 636 "application/json": { 637 "example": { 638 "conformsTo": [ 639 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core", 640 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30", 641 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/html", 642 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson" 643 ] 644 }, 645 "schema": { 646 "$ref": "#/components/schemas/confClasses" 647 } 648 }, 649 "text/html": { 650 "schema": { 651 "type": "string" 652 } 653 } 654 }, 655 "description": "The URIs of all conformance classes supported by the server.\n\nTo support \"generic\" clients that want to access multiple\nOGC API Features implementations - and not \"just\" a specific\nAPI / server, the server declares the conformance\nclasses it implements and conforms to." 656 }, 657 "CoverageTile": { 658 "content": { 659 "application/netcdf": { 660 "schema": { 661 "format": "binary", 662 "type": "string" 663 } 664 }, 665 "image/tiff; application=geotiff": { 666 "schema": { 667 "format": "binary", 668 "type": "string" 669 } 670 } 671 }, 672 "description": "A coverage tile returned as a response." 673 }, 674 "EmptyTile": { 675 "description": "No data available for this tile." 676 }, 677 "Enumeration": { 678 "content": { 679 "application/json": { 680 "schema": { 681 "$ref": "#/components/schemas/enumeration" 682 } 683 }, 684 "text/html": { 685 "schema": { 686 "type": "string" 687 } 688 } 689 }, 690 "description": "An enumerated list of valid string values for API parameters." 691 }, 692 "Exception": { 693 "content": { 694 "application/json": { 695 "schema": { 696 "$ref": "#/components/schemas/exception" 697 } 698 }, 699 "text/html": { 700 "schema": { 701 "type": "string" 702 } 703 } 704 }, 705 "description": "An error occured." 706 }, 707 "Feature": { 708 "content": { 709 "application/geo+json": { 710 "example": { 711 "geometry": { 712 "coordinates": [ 713 "..." 714 ], 715 "type": "Polygon" 716 }, 717 "id": "123", 718 "links": [ 719 { 720 "href": "http://data.example.com/id/building/123", 721 "rel": "canonical", 722 "title": "canonical URI of the building" 723 }, 724 { 725 "href": "http://data.example.com/collections/buildings/items/123.json", 726 "rel": "self", 727 "title": "this document", 728 "type": "application/geo+json" 729 }, 730 { 731 "href": "http://data.example.com/collections/buildings/items/123.html", 732 "rel": "alternate", 733 "title": "this document as HTML", 734 "type": "text/html" 735 }, 736 { 737 "href": "http://data.example.com/collections/buildings", 738 "rel": "collection", 739 "title": "the collection document", 740 "type": "application/geo+json" 741 } 742 ], 743 "properties": { 744 "floors": "2", 745 "function": "residential", 746 "lastUpdate": "2015-08-01T12:34:56Z" 747 }, 748 "type": "Feature" 749 }, 750 "schema": { 751 "$ref": "#/components/schemas/featureGeoJSON" 752 } 753 }, 754 "text/html": { 755 "schema": { 756 "type": "string" 757 } 758 } 759 }, 760 "description": "fetch the feature with id `featureId` in the feature collection\nwith id `collectionId`" 761 }, 762 "Features": { 763 "content": { 764 "application/geo+json": { 765 "example": { 766 "features": [ 767 { 768 "geometry": { 769 "coordinates": [ 770 "..." 771 ], 772 "type": "Polygon" 773 }, 774 "id": "123", 775 "properties": { 776 "floors": "2", 777 "function": "residential", 778 "lastUpdate": "2015-08-01T12:34:56Z" 779 }, 780 "type": "Feature" 781 }, 782 { 783 "geometry": { 784 "coordinates": [ 785 "..." 786 ], 787 "type": "Polygon" 788 }, 789 "id": "132", 790 "properties": { 791 "floors": "10", 792 "function": "public use", 793 "lastUpdate": "2013-12-03T10:15:37Z" 794 }, 795 "type": "Feature" 796 } 797 ], 798 "links": [ 799 { 800 "href": "http://data.example.com/collections/buildings/items.json", 801 "rel": "self", 802 "title": "this document", 803 "type": "application/geo+json" 804 }, 805 { 806 "href": "http://data.example.com/collections/buildings/items.html", 807 "rel": "alternate", 808 "title": "this document as HTML", 809 "type": "text/html" 810 }, 811 { 812 "href": "http://data.example.com/collections/buildings/items.json\u0026offset=10\u0026limit=2", 813 "rel": "next", 814 "title": "next page", 815 "type": "application/geo+json" 816 } 817 ], 818 "numberMatched": 123, 819 "numberReturned": 2, 820 "timeStamp": "2018-04-03T14:52:23Z", 821 "type": "FeatureCollection" 822 }, 823 "schema": { 824 "$ref": "#/components/schemas/featureCollectionGeoJSON" 825 } 826 }, 827 "text/html": { 828 "schema": { 829 "type": "string" 830 } 831 } 832 }, 833 "description": "The response is a document consisting of features in the collection.\nThe features included in the response are determined by the server\nbased on the query parameters of the request. To support access to\nlarger collections without overloading the client, the API supports\npaged access with links to the next page, if more features are selected\nthat the page size.\n\nThe `bbox` and `datetime` parameter can be used to select only a\nsubset of the features in the collection (the features that are in the\nbounding box or time interval). The `bbox` parameter matches all features\nin the collection that are not associated with a location, too. The\n`datetime` parameter matches all features in the collection that are\nnot associated with a time stamp or interval, too.\n\nThe `limit` parameter may be used to control the subset of the\nselected features that should be returned in the response, the page size.\nEach page may include information about the number of selected and\nreturned features (`numberMatched` and `numberReturned`) as well as\nlinks to support paging (link relation `next`)." 834 }, 835 "InvalidParameter": { 836 "content": { 837 "application/json": { 838 "schema": { 839 "$ref": "#/components/schemas/exception" 840 } 841 }, 842 "text/html": { 843 "schema": { 844 "type": "string" 845 } 846 } 847 }, 848 "description": "A query parameter has an invalid value." 849 }, 850 "LandingPage": { 851 "content": { 852 "application/json": { 853 "example": { 854 "description": "Access to data about buildings in the city of Bonn via a Web API that conforms to the OGC API Features specification.", 855 "links": [ 856 { 857 "href": "http://data.example.org/", 858 "rel": "self", 859 "title": "this document", 860 "type": "application/json" 861 }, 862 { 863 "href": "http://data.example.org/api", 864 "rel": "service-desc", 865 "title": "the API definition", 866 "type": "application/vnd.oai.openapi+json;version=3.0" 867 }, 868 { 869 "href": "http://data.example.org/api.html", 870 "rel": "service-doc", 871 "title": "the API documentation", 872 "type": "text/html" 873 }, 874 { 875 "href": "http://data.example.org/conformance", 876 "rel": "conformance", 877 "title": "OGC API conformance classes implemented by this server", 878 "type": "application/json" 879 }, 880 { 881 "href": "http://data.example.org/collections", 882 "rel": "data", 883 "title": "Information about the feature collections", 884 "type": "application/json" 885 } 886 ], 887 "title": "Buildings in Bonn" 888 }, 889 "schema": { 890 "$ref": "#/components/schemas/landingPage" 891 } 892 }, 893 "text/html": { 894 "schema": { 895 "type": "string" 896 } 897 } 898 }, 899 "description": "The landing page provides links to the API definition\n(link relations `service-desc` and `service-doc`),\nthe Conformance declaration (path `/conformance`,\nlink relation `conformance`), and the Feature\nCollections (path `/collections`, link relation\n`data`)." 900 }, 901 "MapTile": { 902 "content": { 903 "image/jpeg": { 904 "schema": { 905 "format": "binary", 906 "type": "string" 907 } 908 }, 909 "image/png": { 910 "schema": { 911 "format": "binary", 912 "type": "string" 913 } 914 }, 915 "image/tiff; application=geotiff": { 916 "schema": { 917 "format": "binary", 918 "type": "string" 919 } 920 } 921 }, 922 "description": "A map tile image returned as a response." 923 }, 924 "NotAcceptable": { 925 "content": { 926 "application/json": { 927 "schema": { 928 "$ref": "#/components/schemas/exception" 929 } 930 }, 931 "text/html": { 932 "schema": { 933 "type": "string" 934 } 935 } 936 }, 937 "description": "Content negotiation failed. For example, the `Accept` header submitted in the request did not support any of the media types supported by the server for the requested resource." 938 }, 939 "NotFound": { 940 "content": { 941 "application/json": { 942 "schema": { 943 "$ref": "#/components/schemas/exception" 944 } 945 }, 946 "text/html": { 947 "schema": { 948 "type": "string" 949 } 950 } 951 }, 952 "description": "The requested resource does not exist on the server. For example, a path parameter had an incorrect value." 953 }, 954 "ServerError": { 955 "content": { 956 "application/json": { 957 "schema": { 958 "$ref": "#/components/schemas/exception" 959 } 960 }, 961 "text/html": { 962 "schema": { 963 "type": "string" 964 } 965 } 966 }, 967 "description": "A server error occurred." 968 }, 969 "TileMatrixSet": { 970 "content": { 971 "application/json": { 972 "schema": { 973 "$ref": "#/components/schemas/tileMatrixSet" 974 } 975 } 976 }, 977 "description": "tile matrix set" 978 }, 979 "TileMatrixSetsList": { 980 "content": { 981 "application/json": { 982 "schema": { 983 "properties": { 984 "tileMatrixSets": { 985 "items": { 986 "$ref": "#/components/schemas/tileMatrixSet-item" 987 }, 988 "type": "array" 989 } 990 }, 991 "type": "object" 992 } 993 }, 994 "text/html": { 995 "schema": { 996 "type": "string" 997 } 998 } 999 }, 1000 "description": "List of tile matrix sets (tiling schemes)." 1001 }, 1002 "TileSet": { 1003 "content": { 1004 "application/json": { 1005 "schema": { 1006 "$ref": "#/components/schemas/tileSet" 1007 } 1008 }, 1009 "text/html": { 1010 "schema": { 1011 "type": "string" 1012 } 1013 } 1014 }, 1015 "description": "Description of the tileset" 1016 }, 1017 "TileSetsList": { 1018 "content": { 1019 "application/json": { 1020 "schema": { 1021 "properties": { 1022 "links": { 1023 "items": { 1024 "$ref": "#/components/schemas/link" 1025 }, 1026 "type": "array" 1027 }, 1028 "tilesets": { 1029 "items": { 1030 "$ref": "#/components/schemas/tileSet-item" 1031 }, 1032 "type": "array" 1033 } 1034 }, 1035 "required": [ 1036 "tilesets" 1037 ], 1038 "type": "object" 1039 } 1040 }, 1041 "text/html": { 1042 "schema": { 1043 "type": "string" 1044 } 1045 } 1046 }, 1047 "description": "List of available tilesets." 1048 }, 1049 "VectorTile": { 1050 "content": { 1051 "application/geo+json": { 1052 "schema": { 1053 "allOf": [ 1054 { 1055 "format": "geojson-feature-collection" 1056 }, 1057 { 1058 "$ref": "#/components/schemas/FeatureCollection" 1059 } 1060 ] 1061 } 1062 }, 1063 "application/vnd.mapbox-vector-tile": { 1064 "schema": { 1065 "format": "binary", 1066 "type": "string" 1067 } 1068 } 1069 }, 1070 "description": "A vector tile returned as a response." 1071 } 1072 }, 1073 "schemas": { 1074 "2DBoundingBox": { 1075 "description": "Minimum bounding rectangle surrounding a 2D resource in the CRS indicated elsewhere", 1076 "properties": { 1077 "crs": { 1078 "$ref": "#/components/schemas/crs" 1079 }, 1080 "lowerLeft": { 1081 "$ref": "#/components/schemas/2DPoint" 1082 }, 1083 "orderedAxes": { 1084 "items": { 1085 "type": "string" 1086 }, 1087 "maxItems": 2, 1088 "minItems": 2, 1089 "type": "array" 1090 }, 1091 "upperRight": { 1092 "$ref": "#/components/schemas/2DPoint" 1093 } 1094 }, 1095 "required": [ 1096 "lowerLeft", 1097 "upperRight" 1098 ], 1099 "type": "object" 1100 }, 1101 "2DPoint": { 1102 "description": "A 2D Point in the CRS indicated elsewhere", 1103 "items": { 1104 "type": "number" 1105 }, 1106 "maxItems": 2, 1107 "minItems": 2, 1108 "type": "array" 1109 }, 1110 "FeatureCollection": { 1111 "properties": { 1112 "bbox": { 1113 "items": { 1114 "type": "number" 1115 }, 1116 "minItems": 4, 1117 "type": "array" 1118 }, 1119 "features": { 1120 "items": { 1121 "properties": { 1122 "bbox": { 1123 "items": { 1124 "type": "number" 1125 }, 1126 "minItems": 4, 1127 "type": "array" 1128 }, 1129 "geometry": { 1130 "oneOf": [ 1131 { 1132 "nullable": true, 1133 "properties": { 1134 "bbox": { 1135 "items": { 1136 "type": "number" 1137 }, 1138 "minItems": 4, 1139 "type": "array" 1140 }, 1141 "coordinates": { 1142 "items": { 1143 "type": "number" 1144 }, 1145 "minItems": 2, 1146 "type": "array" 1147 }, 1148 "type": { 1149 "enum": [ 1150 "Point" 1151 ], 1152 "type": "string" 1153 } 1154 }, 1155 "required": [ 1156 "type", 1157 "coordinates" 1158 ], 1159 "title": "GeoJSON Point", 1160 "type": "object" 1161 }, 1162 { 1163 "properties": { 1164 "bbox": { 1165 "items": { 1166 "type": "number" 1167 }, 1168 "minItems": 4, 1169 "type": "array" 1170 }, 1171 "coordinates": { 1172 "items": { 1173 "items": { 1174 "type": "number" 1175 }, 1176 "minItems": 2, 1177 "type": "array" 1178 }, 1179 "minItems": 2, 1180 "type": "array" 1181 }, 1182 "type": { 1183 "enum": [ 1184 "LineString" 1185 ], 1186 "type": "string" 1187 } 1188 }, 1189 "required": [ 1190 "type", 1191 "coordinates" 1192 ], 1193 "title": "GeoJSON LineString", 1194 "type": "object" 1195 }, 1196 { 1197 "properties": { 1198 "bbox": { 1199 "items": { 1200 "type": "number" 1201 }, 1202 "minItems": 4, 1203 "type": "array" 1204 }, 1205 "coordinates": { 1206 "items": { 1207 "items": { 1208 "items": { 1209 "type": "number" 1210 }, 1211 "minItems": 2, 1212 "type": "array" 1213 }, 1214 "minItems": 4, 1215 "type": "array" 1216 }, 1217 "type": "array" 1218 }, 1219 "type": { 1220 "enum": [ 1221 "Polygon" 1222 ], 1223 "type": "string" 1224 } 1225 }, 1226 "required": [ 1227 "type", 1228 "coordinates" 1229 ], 1230 "title": "GeoJSON Polygon", 1231 "type": "object" 1232 }, 1233 { 1234 "properties": { 1235 "bbox": { 1236 "items": { 1237 "type": "number" 1238 }, 1239 "minItems": 4, 1240 "type": "array" 1241 }, 1242 "coordinates": { 1243 "items": { 1244 "items": { 1245 "type": "number" 1246 }, 1247 "minItems": 2, 1248 "type": "array" 1249 }, 1250 "type": "array" 1251 }, 1252 "type": { 1253 "enum": [ 1254 "MultiPoint" 1255 ], 1256 "type": "string" 1257 } 1258 }, 1259 "required": [ 1260 "type", 1261 "coordinates" 1262 ], 1263 "title": "GeoJSON MultiPoint", 1264 "type": "object" 1265 }, 1266 { 1267 "properties": { 1268 "bbox": { 1269 "items": { 1270 "type": "number" 1271 }, 1272 "minItems": 4, 1273 "type": "array" 1274 }, 1275 "coordinates": { 1276 "items": { 1277 "items": { 1278 "items": { 1279 "type": "number" 1280 }, 1281 "minItems": 2, 1282 "type": "array" 1283 }, 1284 "minItems": 2, 1285 "type": "array" 1286 }, 1287 "type": "array" 1288 }, 1289 "type": { 1290 "enum": [ 1291 "MultiLineString" 1292 ], 1293 "type": "string" 1294 } 1295 }, 1296 "required": [ 1297 "type", 1298 "coordinates" 1299 ], 1300 "title": "GeoJSON MultiLineString", 1301 "type": "object" 1302 }, 1303 { 1304 "properties": { 1305 "bbox": { 1306 "items": { 1307 "type": "number" 1308 }, 1309 "minItems": 4, 1310 "type": "array" 1311 }, 1312 "coordinates": { 1313 "items": { 1314 "items": { 1315 "items": { 1316 "items": { 1317 "type": "number" 1318 }, 1319 "minItems": 2, 1320 "type": "array" 1321 }, 1322 "minItems": 4, 1323 "type": "array" 1324 }, 1325 "type": "array" 1326 }, 1327 "type": "array" 1328 }, 1329 "type": { 1330 "enum": [ 1331 "MultiPolygon" 1332 ], 1333 "type": "string" 1334 } 1335 }, 1336 "required": [ 1337 "type", 1338 "coordinates" 1339 ], 1340 "title": "GeoJSON MultiPolygon", 1341 "type": "object" 1342 } 1343 ] 1344 }, 1345 "id": { 1346 "oneOf": [ 1347 { 1348 "type": "number" 1349 }, 1350 { 1351 "type": "string" 1352 } 1353 ] 1354 }, 1355 "properties": { 1356 "nullable": true, 1357 "type": "object" 1358 }, 1359 "type": { 1360 "enum": [ 1361 "Feature" 1362 ], 1363 "type": "string" 1364 } 1365 }, 1366 "required": [ 1367 "type", 1368 "properties", 1369 "geometry" 1370 ], 1371 "title": "GeoJSON Feature", 1372 "type": "object" 1373 }, 1374 "type": "array" 1375 }, 1376 "type": { 1377 "enum": [ 1378 "FeatureCollection" 1379 ], 1380 "type": "string" 1381 } 1382 }, 1383 "required": [ 1384 "type", 1385 "features" 1386 ], 1387 "title": "GeoJSON FeatureCollection", 1388 "type": "object" 1389 }, 1390 "all-collections": { 1391 "enum": [ 1392 "blueMarble", 1393 "NaturalEarth:raster:HYP_HR_SR_OB_DR", 1394 "NaturalEarth:cultural:ne_10m_admin_0_countries", 1395 "NaturalEarth:physical:bathymetry", 1396 "SRTM_ViewFinderPanorama", 1397 "HRDEM-Ottawa", 1398 "HRDEM-RedRiver" 1399 ], 1400 "type": "string" 1401 }, 1402 "collection": { 1403 "properties": { 1404 "crs": { 1405 "default": [ 1406 "http://www.opengis.net/def/crs/OGC/1.3/CRS84" 1407 ], 1408 "description": "the list of coordinate reference systems supported by the service", 1409 "example": [ 1410 "http://www.opengis.net/def/crs/OGC/1.3/CRS84", 1411 "http://www.opengis.net/def/crs/EPSG/0/4326" 1412 ], 1413 "items": { 1414 "type": "string" 1415 }, 1416 "type": "array" 1417 }, 1418 "description": { 1419 "description": "a description of the features in the collection", 1420 "example": "An address.", 1421 "type": "string" 1422 }, 1423 "extent": { 1424 "$ref": "#/components/schemas/extent" 1425 }, 1426 "id": { 1427 "description": "identifier of the collection used, for example, in URIs", 1428 "example": "address", 1429 "type": "string" 1430 }, 1431 "itemType": { 1432 "default": "feature", 1433 "description": "indicator about the type of the items in the collection (the default value is 'feature').", 1434 "type": "string" 1435 }, 1436 "links": { 1437 "example": [ 1438 { 1439 "href": "http://data.example.com/buildings", 1440 "rel": "item" 1441 }, 1442 { 1443 "href": "http://example.com/concepts/buildings.html", 1444 "rel": "describedby", 1445 "type": "text/html" 1446 } 1447 ], 1448 "items": { 1449 "$ref": "#/components/schemas/link" 1450 }, 1451 "type": "array" 1452 }, 1453 "title": { 1454 "description": "human readable title of the collection", 1455 "example": "address", 1456 "type": "string" 1457 } 1458 }, 1459 "required": [ 1460 "id", 1461 "links" 1462 ], 1463 "type": "object" 1464 }, 1465 "collectionInfo": { 1466 "properties": { 1467 "crs": { 1468 "default": [ 1469 "http://www.opengis.net/def/crs/OGC/1.3/CRS84" 1470 ], 1471 "description": "the list of coordinate reference systems supported by the API; the first item is the default coordinate reference system", 1472 "example": [ 1473 "http://www.opengis.net/def/crs/OGC/1.3/CRS84", 1474 "http://www.opengis.net/def/crs/EPSG/0/4326" 1475 ], 1476 "items": { 1477 "type": "string" 1478 }, 1479 "type": "array" 1480 }, 1481 "dataType": { 1482 "allOf": [ 1483 { 1484 "description": "Type of data represented in the collection" 1485 }, 1486 { 1487 "$ref": "#/components/schemas/dataType" 1488 } 1489 ] 1490 }, 1491 "description": { 1492 "description": "a description of the data in the collection", 1493 "example": "A Digital Elevation Model.", 1494 "type": "string" 1495 }, 1496 "extent": { 1497 "$ref": "#/components/schemas/extent-uad" 1498 }, 1499 "geometryDimension": { 1500 "description": "The geometry dimension of the features shown in this layer (0: points, 1: curves, 2: surfaces, 3: solids), unspecified: mixed or unknown", 1501 "maximum": 3, 1502 "minimum": 0, 1503 "type": "integer" 1504 }, 1505 "id": { 1506 "description": "identifier of the collection used, for example, in URIs", 1507 "example": "dem", 1508 "type": "string" 1509 }, 1510 "itemType": { 1511 "default": "unknown", 1512 "description": "indicator about the type of the items in the collection if the collection has an accessible /collections/{collectionId}/items endpoint", 1513 "type": "string" 1514 }, 1515 "links": { 1516 "example": [ 1517 { 1518 "href": "http://data.example.org/collections/dem?f=json", 1519 "rel": "self", 1520 "title": "Digital Elevation Model", 1521 "type": "application/json" 1522 }, 1523 { 1524 "href": "http://data.example.org/collections/dem?f=html", 1525 "rel": "alternate", 1526 "title": "Digital Elevation Model", 1527 "type": "application/json" 1528 }, 1529 { 1530 "href": "http://data.example.org/collections/dem/coverage", 1531 "rel": "coverage", 1532 "title": "Digital Elevation Model", 1533 "type": "image/tiff; application=geotiff" 1534 }, 1535 { 1536 "href": "http://data.example.org/collections/dem/coverage/domainset", 1537 "rel": "domainset", 1538 "title": "Digital Elevation Model", 1539 "type": "application/json" 1540 }, 1541 { 1542 "href": "http://data.example.org/collections/dem/coverage/rangetype", 1543 "rel": "rangetype", 1544 "title": "Digital Elevation Model", 1545 "type": "application/json" 1546 }, 1547 { 1548 "href": "http://data.example.org/collections/dem/coverage/metadata", 1549 "rel": "metadata", 1550 "title": "Digital Elevation Model", 1551 "type": "application/json" 1552 } 1553 ], 1554 "items": { 1555 "$ref": "#/components/schemas/link" 1556 }, 1557 "type": "array" 1558 }, 1559 "maxCellSize": { 1560 "description": "Maximum cell size for usage of the collection", 1561 "type": "number" 1562 }, 1563 "maxScaleDenominator": { 1564 "description": "Maximum scale denominator for usage of the collection", 1565 "type": "number" 1566 }, 1567 "minCellSize": { 1568 "description": "Minimum cell size for usage of the collection", 1569 "type": "number" 1570 }, 1571 "minScaleDenominator": { 1572 "description": "Minimum scale denominator for usage of the collection", 1573 "type": "number" 1574 }, 1575 "title": { 1576 "description": "human readable title of the collection", 1577 "example": "Digital Elevation Model", 1578 "type": "string" 1579 } 1580 }, 1581 "required": [ 1582 "id", 1583 "links" 1584 ], 1585 "type": "object" 1586 }, 1587 "collections": { 1588 "properties": { 1589 "collections": { 1590 "items": { 1591 "$ref": "#/components/schemas/collection" 1592 }, 1593 "type": "array" 1594 }, 1595 "links": { 1596 "items": { 1597 "$ref": "#/components/schemas/link" 1598 }, 1599 "type": "array" 1600 }, 1601 "numberMatched": { 1602 "example": 1, 1603 "minimum": 0, 1604 "type": "integer" 1605 }, 1606 "numberReturned": { 1607 "example": 1, 1608 "minimum": 0, 1609 "type": "integer" 1610 }, 1611 "timeStamp": { 1612 "format": "date-time", 1613 "type": "string" 1614 } 1615 }, 1616 "required": [ 1617 "collections", 1618 "links" 1619 ], 1620 "type": "object" 1621 }, 1622 "confClasses": { 1623 "properties": { 1624 "conformsTo": { 1625 "items": { 1626 "type": "string" 1627 }, 1628 "type": "array" 1629 } 1630 }, 1631 "required": [ 1632 "conformsTo" 1633 ], 1634 "type": "object" 1635 }, 1636 "coverage-collections": { 1637 "enum": [ 1638 "SRTM_ViewFinderPanorama", 1639 "HRDEM-Ottawa", 1640 "HRDEM-RedRiver" 1641 ], 1642 "type": "string" 1643 }, 1644 "crs": { 1645 "oneOf": [ 1646 { 1647 "description": "Simplification of the object into a url if the other properties are not present", 1648 "type": "string" 1649 }, 1650 { 1651 "oneOf": [ 1652 { 1653 "properties": { 1654 "uri": { 1655 "description": "Reference to one coordinate reference system (CRS)", 1656 "format": "uri", 1657 "type": "string" 1658 } 1659 }, 1660 "required": [ 1661 "uri" 1662 ] 1663 }, 1664 { 1665 "properties": { 1666 "wkt": { 1667 "allOf": [ 1668 { 1669 "description": "An object defining the CRS using the JSON encoding for Well-known text representation of coordinate reference systems 2.0" 1670 }, 1671 { 1672 "type": "object" 1673 } 1674 ] 1675 } 1676 }, 1677 "required": [ 1678 "wkt" 1679 ] 1680 }, 1681 { 1682 "properties": { 1683 "referenceSystem": { 1684 "description": "A reference system data structure as defined in the MD_ReferenceSystem of the ISO 19115", 1685 "type": "object" 1686 } 1687 }, 1688 "required": [ 1689 "referenceSystem" 1690 ] 1691 } 1692 ], 1693 "type": "object" 1694 } 1695 ], 1696 "title": "CRS" 1697 }, 1698 "dataType": { 1699 "anyOf": [ 1700 { 1701 "type": "string" 1702 }, 1703 { 1704 "enum": [ 1705 "map", 1706 "vector", 1707 "coverage" 1708 ], 1709 "type": "string" 1710 } 1711 ] 1712 }, 1713 "enumeration": { 1714 "properties": { 1715 "enum": { 1716 "items": { 1717 "type": "string" 1718 }, 1719 "type": "array" 1720 }, 1721 "type": { 1722 "enum": [ 1723 "enum" 1724 ], 1725 "type": "string" 1726 } 1727 }, 1728 "required": [ 1729 "type", 1730 "enum" 1731 ], 1732 "type": "object" 1733 }, 1734 "exception": { 1735 "description": "Information about the exception: an error code plus an optional description.", 1736 "properties": { 1737 "code": { 1738 "type": "string" 1739 }, 1740 "description": { 1741 "type": "string" 1742 }, 1743 "detail": { 1744 "type": "string" 1745 }, 1746 "instance": { 1747 "type": "string" 1748 }, 1749 "status": { 1750 "type": "integer" 1751 }, 1752 "title": { 1753 "type": "string" 1754 }, 1755 "type": { 1756 "type": "string" 1757 } 1758 }, 1759 "required": [ 1760 "code" 1761 ], 1762 "title": "Exception Schema", 1763 "type": "object" 1764 }, 1765 "extent": { 1766 "description": "The extent of the features in the collection. In the Core only spatial and temporal\nextents are specified. Extensions may add additional members to represent other\nextents, for example, thermal or pressure ranges.", 1767 "properties": { 1768 "spatial": { 1769 "$ref": "#/components/schemas/extent_spatial", 1770 "description": "The spatial extent of the data in the collection.", 1771 "properties": { 1772 "bbox": { 1773 "description": "One or more bounding boxes that describe the spatial extent of the dataset.\nIn the Core only a single bounding box is supported.\n\nExtensions may support additional areas.\nThe first bounding box describes the overall spatial\nextent of the data. All subsequent bounding boxes describe\nmore precise bounding boxes, e.g., to identify clusters of data.\nClients only interested in the overall spatial extent will\nonly need to access the first item in each array.", 1774 "items": { 1775 "description": "Each bounding box is provided as four or six numbers, depending on\nwhether the coordinate reference system includes a vertical axis\n(height or depth):\n\n* Lower left corner, coordinate axis 1\n* Lower left corner, coordinate axis 2\n* Minimum value, coordinate axis 3 (optional)\n* Upper right corner, coordinate axis 1\n* Upper right corner, coordinate axis 2\n* Maximum value, coordinate axis 3 (optional)\n\nIf the value consists of four numbers, the coordinate reference system is\nWGS 84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84)\nunless a different coordinate reference system is specified in a parameter `bbox-crs`.\n\nIf the value consists of six numbers, the coordinate reference system is WGS 84\nlongitude/latitude/ellipsoidal height (http://www.opengis.net/def/crs/OGC/0/CRS84h)\nunless a different coordinate reference system is specified in a parameter `bbox-crs`.\n\nFor WGS 84 longitude/latitude the values are in most cases the sequence of\nminimum longitude, minimum latitude, maximum longitude and maximum latitude.\nHowever, in cases where the box spans the antimeridian the first value\n(west-most box edge) is larger than the third value (east-most box edge).\n\nIf the vertical axis is included, the third and the sixth number are\nthe bottom and the top of the 3-dimensional bounding box.\n\nIf a feature has multiple spatial geometry properties, it is the decision of the\nserver whether only a single spatial geometry property is used to determine\nthe extent or all relevant geometries.", 1776 "example": [ 1777 -180, 1778 -90, 1779 180, 1780 90 1781 ], 1782 "items": { 1783 "type": "number" 1784 }, 1785 "oneOf": [ 1786 { 1787 "maxItems": 4, 1788 "minItems": 4 1789 }, 1790 { 1791 "maxItems": 6, 1792 "minItems": 6 1793 } 1794 ], 1795 "type": "array" 1796 }, 1797 "minItems": 1, 1798 "type": "array" 1799 }, 1800 "crs": { 1801 "default": "http://www.opengis.net/def/crs/OGC/1.3/CRS84", 1802 "description": "Coordinate reference system of the coordinates in the spatial extent\n(property `bbox`). The default reference system is WGS 84 longitude/latitude.\nIn the Core the only other supported coordinate reference system is\nWGS 84 longitude/latitude/ellipsoidal height for coordinates with height.\nExtensions may support additional coordinate reference systems and add\nadditional enum values.", 1803 "enum": [ 1804 "http://www.opengis.net/def/crs/OGC/1.3/CRS84", 1805 "http://www.opengis.net/def/crs/OGC/0/CRS84h" 1806 ], 1807 "type": "string" 1808 }, 1809 "grid": { 1810 "description": "Provides information about the limited availability of data within the collection organized\nas a grid (regular or irregular) along each spatial dimension.", 1811 "items": { 1812 "properties": { 1813 "cellsCount": { 1814 "description": "Number of samples available along the dimension for data organized as a regular grid.\nFor values representing the whole area of contiguous cells spanning _resolution_ units along the dimension, this will be (_upperBound_ - _lowerBound_) / _resolution_.\nFor values representing infinitely small point cells spaced by _resolution_ units along the dimension, this will be (_upperBound_ - _lowerBound_) / _resolution_ + 1.", 1815 "example": 50, 1816 "type": "integer" 1817 }, 1818 "coordinates": { 1819 "description": "List of coordinates along the dimension for which data organized as an irregular grid in the collection is available\n(e.g., 2, 10, 80, 100).", 1820 "example": [ 1821 2, 1822 10, 1823 80, 1824 100 1825 ], 1826 "items": { 1827 "oneOf": [ 1828 { 1829 "nullable": true, 1830 "type": "string" 1831 }, 1832 { 1833 "type": "number" 1834 } 1835 ] 1836 }, 1837 "minItems": 1, 1838 "type": "array" 1839 }, 1840 "resolution": { 1841 "description": "Resolution of regularly gridded data along the dimension in the collection", 1842 "example": 0.0006866455078, 1843 "oneOf": [ 1844 { 1845 "nullable": true, 1846 "type": "string" 1847 }, 1848 { 1849 "type": "number" 1850 } 1851 ] 1852 } 1853 }, 1854 "type": "object" 1855 }, 1856 "maxItems": 3, 1857 "minItems": 2, 1858 "type": "array" 1859 } 1860 }, 1861 "type": "object" 1862 }, 1863 "temporal": { 1864 "$ref": "#/components/schemas/extent_temporal", 1865 "description": "The temporal extent of the features in the collection.", 1866 "properties": { 1867 "grid": { 1868 "description": "Provides information about the limited availability of data within the collection organized as a grid (regular or irregular) along the temporal dimension.", 1869 "properties": { 1870 "cellsCount": { 1871 "description": "Number of samples available along the temporal dimension for data organized as a regular grid.\nFor values representing the whole area of contiguous cells spanning _resolution_ units along the dimension, this will be (_upperBound_ - _lowerBound_) / _resolution_.\nFor values representing infinitely small point cells spaced by _resolution_ units along the dimension, this will be (_upperBound_ - _lowerBound_) / _resolution_ + 1.", 1872 "example": 50, 1873 "type": "integer" 1874 }, 1875 "coordinates": { 1876 "description": "List of coordinates along the temporal dimension for which data organized as an irregular grid in the collection is available\n(e.g., \"2017-11-14T09:00Z\",\"2017-11-14T12:00Z\",\"2017-11-14T15:00Z\",\"2017-11-14T18:00Z\",\"2017-11-14T21:00Z\").", 1877 "example": [ 1878 [ 1879 "2020-11-12T12:15Z", 1880 "2020-11-12T12:30Z", 1881 "2020-11-12T12:45Z" 1882 ] 1883 ], 1884 "items": { 1885 "nullable": true, 1886 "type": "string" 1887 }, 1888 "minItems": 1, 1889 "type": "array" 1890 }, 1891 "resolution": { 1892 "description": "Resolution of regularly gridded data along the temporal dimension in the collection", 1893 "example": "PT1H", 1894 "oneOf": [ 1895 { 1896 "nullable": true, 1897 "type": "string" 1898 }, 1899 { 1900 "type": "number" 1901 } 1902 ] 1903 } 1904 }, 1905 "type": "object" 1906 }, 1907 "interval": { 1908 "description": "One or more time intervals that describe the temporal extent of the dataset.\nIn the Core only a single time interval is supported.\n\nExtensions may support multiple intervals.\nThe first time interval describes the overall\ntemporal extent of the data. All subsequent time intervals describe\nmore precise time intervals, e.g., to identify clusters of data.\nClients only interested in the overall extent will only need\nto access the first item in each array.", 1909 "items": { 1910 "description": "Begin and end times of the time interval. The timestamps are in the\ntemporal coordinate reference system specified in `trs`. By default\nthis is the Gregorian calendar.\n\nThe value `null` for start or end time is supported and indicates a half-bounded time interval.", 1911 "example": [ 1912 "2011-11-11T12:22:11Z", 1913 null 1914 ], 1915 "items": { 1916 "format": "date-time", 1917 "nullable": true, 1918 "type": "string" 1919 }, 1920 "maxItems": 2, 1921 "minItems": 2, 1922 "type": "array" 1923 }, 1924 "minItems": 1, 1925 "type": "array" 1926 }, 1927 "trs": { 1928 "default": "http://www.opengis.net/def/uom/ISO-8601/0/Gregorian", 1929 "description": "Coordinate reference system of the coordinates in the temporal extent\n(property `interval`). The default reference system is the Gregorian calendar.\nIn the Core this is the only supported temporal coordinate reference system.\nExtensions may support additional temporal coordinate reference systems and add\nadditional enum values.", 1930 "enum": [ 1931 "http://www.opengis.net/def/uom/ISO-8601/0/Gregorian" 1932 ], 1933 "type": "string" 1934 } 1935 }, 1936 "type": "object" 1937 } 1938 }, 1939 "type": "object" 1940 }, 1941 "extent-uad": { 1942 "allOf": [ 1943 { 1944 "$ref": "#/components/schemas/extent" 1945 }, 1946 { 1947 "additionalProperties": { 1948 "description": "The domain intervals for any additional dimensions of the extent (envelope) beyond those described in temporal and spatial.", 1949 "oneOf": [ 1950 { 1951 "required": [ 1952 "interval", 1953 "crs" 1954 ] 1955 }, 1956 { 1957 "required": [ 1958 "interval", 1959 "trs" 1960 ] 1961 }, 1962 { 1963 "required": [ 1964 "interval", 1965 "vrs" 1966 ] 1967 } 1968 ], 1969 "properties": { 1970 "crs": { 1971 "description": "generic coordinate reference system suitable for any type of dimensions", 1972 "type": "string" 1973 }, 1974 "grid": { 1975 "description": "Provides information about the limited availability of data within the collection organized as a grid (regular or irregular) along the dimension.", 1976 "properties": { 1977 "cellsCount": { 1978 "description": "Number of samples available along the dimension for data organized as a regular grid.\nFor values representing the whole area of contiguous cells spanning _resolution_ units along the dimension, this will be (_upperBound_ - _lowerBound_) / _resolution_.\nFor values representing infinitely small point cells spaced by _resolution_ units along the dimension, this will be (_upperBound_ - _lowerBound_) / _resolution_ + 1.", 1979 "example": 50, 1980 "type": "integer" 1981 }, 1982 "coordinates": { 1983 "description": "List of coordinates along the temporal dimension for which data organized as an irregular grid in the collection is available\n(e.g., 2, 10, 80, 100).", 1984 "example": [ 1985 2, 1986 10, 1987 80, 1988 100 1989 ], 1990 "items": { 1991 "oneOf": [ 1992 { 1993 "nullable": true, 1994 "type": "string" 1995 }, 1996 { 1997 "type": "number" 1998 } 1999 ] 2000 }, 2001 "minItems": 1, 2002 "type": "array" 2003 }, 2004 "resolution": { 2005 "description": "Resolution of regularly gridded data along the dimension in the collection", 2006 "example": [ 2007 "PT1H", 2008 0.0006866455078 2009 ], 2010 "oneOf": [ 2011 { 2012 "nullable": true, 2013 "type": "string" 2014 }, 2015 { 2016 "type": "number" 2017 } 2018 ] 2019 } 2020 }, 2021 "type": "object" 2022 }, 2023 "interval": { 2024 "description": "One or more intervals that describe the extent for this dimension of the dataset.\nThe value `null` is supported and indicates an unbounded or half-bounded interval.\nThe first interval describes the overall extent of the data for this dimension.\nAll subsequent intervals describe more precise intervals, e.g., to identify clusters of data.\nClients only interested in the overall extent will only need\nto access the first item (a pair of lower and upper bound values).", 2025 "items": { 2026 "description": "Lower and upper bound values of the interval. The values\nare in the coordinate reference system specified in `crs`, `trs` or `vrs`.", 2027 "example": [ 2028 "2011-11-11T12:22:11Z", 2029 32.5, 2030 null 2031 ], 2032 "items": { 2033 "oneOf": [ 2034 { 2035 "nullable": true, 2036 "type": "string" 2037 }, 2038 { 2039 "type": "number" 2040 } 2041 ] 2042 }, 2043 "maxItems": 2, 2044 "minItems": 2, 2045 "type": "array" 2046 }, 2047 "minItems": 1, 2048 "type": "array" 2049 }, 2050 "trs": { 2051 "description": "temporal coordinate reference system (e.g. as defined by Features for 'temporal')", 2052 "type": "string" 2053 }, 2054 "vrs": { 2055 "description": "vertical coordinate reference system (e.g. as defined in EDR for 'vertical')", 2056 "type": "string" 2057 } 2058 }, 2059 "type": "object" 2060 }, 2061 "type": "object" 2062 } 2063 ], 2064 "description": "The extent module only addresses spatial and temporal extents. This module extends extent by specifying how\nintervals and crs properties can be used to specify additional geometries.", 2065 "title": "Extent with Uniform Additional Dimensions Schema" 2066 }, 2067 "extent_spatial": { 2068 "description": "The spatial extent of the features in the collection.", 2069 "properties": { 2070 "bbox": { 2071 "description": "One or more bounding boxes that describe the spatial extent of the dataset.\nIn the Core only a single bounding box is supported. Extensions may support\nadditional areas. If multiple areas are provided, the union of the bounding\nboxes describes the spatial extent.", 2072 "items": { 2073 "description": "Each bounding box is provided as four or six numbers, depending on\nwhether the coordinate reference system includes a vertical axis\n(height or depth):\n\n* Lower left corner, coordinate axis 1\n* Lower left corner, coordinate axis 2\n* Minimum value, coordinate axis 3 (optional)\n* Upper right corner, coordinate axis 1\n* Upper right corner, coordinate axis 2\n* Maximum value, coordinate axis 3 (optional)\n\nThe coordinate reference system of the values is WGS 84 longitude/latitude\n(http://www.opengis.net/def/crs/OGC/1.3/CRS84) unless a different coordinate\nreference system is specified in `crs`.\n\nFor WGS 84 longitude/latitude the values are in most cases the sequence of\nminimum longitude, minimum latitude, maximum longitude and maximum latitude.\nHowever, in cases where the box spans the antimeridian the first value\n(west-most box edge) is larger than the third value (east-most box edge).\n\nIf the vertical axis is included, the third and the sixth number are\nthe bottom and the top of the 3-dimensional bounding box.\n\nIf a feature has multiple spatial geometry properties, it is the decision of the\nserver whether only a single spatial geometry property is used to determine\nthe extent or all relevant geometries.", 2074 "example": [ 2075 -180, 2076 -90, 2077 180, 2078 90 2079 ], 2080 "items": { 2081 "type": "number" 2082 }, 2083 "type": "array" 2084 }, 2085 "minItems": 1, 2086 "type": "array" 2087 }, 2088 "crs": { 2089 "default": "http://www.opengis.net/def/crs/OGC/1.3/CRS84", 2090 "description": "Coordinate reference system of the coordinates in the spatial extent\n(property `bbox`). The default reference system is WGS 84 longitude/latitude.\nIn the Core this is the only supported coordinate reference system.\nExtensions may support additional coordinate reference systems and add\nadditional enum values.", 2091 "enum": [ 2092 "http://www.opengis.net/def/crs/OGC/1.3/CRS84" 2093 ], 2094 "type": "string" 2095 } 2096 }, 2097 "type": "object" 2098 }, 2099 "extent_temporal": { 2100 "description": "The temporal extent of the features in the collection.", 2101 "properties": { 2102 "interval": { 2103 "description": "One or more time intervals that describe the temporal extent of the dataset.\nThe value `null` is supported and indicates an unbounded interval end.\nIn the Core only a single time interval is supported. Extensions may support\nmultiple intervals. If multiple intervals are provided, the union of the\nintervals describes the temporal extent.", 2104 "items": { 2105 "description": "Begin and end times of the time interval. The timestamps are in the\ntemporal coordinate reference system specified in `trs`. By default\nthis is the Gregorian calendar.", 2106 "example": [ 2107 "2011-11-11T12:22:11Z", 2108 null 2109 ], 2110 "items": { 2111 "format": "date-time", 2112 "nullable": true, 2113 "type": "string" 2114 }, 2115 "maxItems": 2, 2116 "minItems": 2, 2117 "type": "array" 2118 }, 2119 "minItems": 1, 2120 "type": "array" 2121 }, 2122 "trs": { 2123 "default": "http://www.opengis.net/def/uom/ISO-8601/0/Gregorian", 2124 "description": "Coordinate reference system of the coordinates in the temporal extent\n(property `interval`). The default reference system is the Gregorian calendar.\nIn the Core this is the only supported temporal coordinate reference system.\nExtensions may support additional temporal coordinate reference systems and add\nadditional enum values.", 2125 "enum": [ 2126 "http://www.opengis.net/def/uom/ISO-8601/0/Gregorian" 2127 ], 2128 "type": "string" 2129 } 2130 }, 2131 "type": "object" 2132 }, 2133 "featureCollectionGeoJSON": { 2134 "properties": { 2135 "features": { 2136 "items": { 2137 "$ref": "#/components/schemas/featureGeoJSON" 2138 }, 2139 "type": "array" 2140 }, 2141 "links": { 2142 "items": { 2143 "$ref": "#/components/schemas/link" 2144 }, 2145 "type": "array" 2146 }, 2147 "numberMatched": { 2148 "$ref": "#/components/schemas/numberMatched" 2149 }, 2150 "numberReturned": { 2151 "$ref": "#/components/schemas/numberReturned" 2152 }, 2153 "timeStamp": { 2154 "$ref": "#/components/schemas/timeStamp" 2155 }, 2156 "type": { 2157 "enum": [ 2158 "FeatureCollection" 2159 ], 2160 "type": "string" 2161 } 2162 }, 2163 "required": [ 2164 "features", 2165 "type" 2166 ], 2167 "type": "object" 2168 }, 2169 "featureGeoJSON": { 2170 "properties": { 2171 "geometry": { 2172 "$ref": "#/components/schemas/geometryGeoJSON" 2173 }, 2174 "id": { 2175 "oneOf": [ 2176 { 2177 "type": "string" 2178 }, 2179 { 2180 "type": "integer" 2181 } 2182 ] 2183 }, 2184 "links": { 2185 "items": { 2186 "$ref": "#/components/schemas/link" 2187 }, 2188 "type": "array" 2189 }, 2190 "properties": { 2191 "nullable": true, 2192 "type": "object" 2193 }, 2194 "type": { 2195 "enum": [ 2196 "Feature" 2197 ], 2198 "type": "string" 2199 } 2200 }, 2201 "required": [ 2202 "geometry", 2203 "properties", 2204 "type" 2205 ], 2206 "type": "object" 2207 }, 2208 "geometryGeoJSON": { 2209 "oneOf": [ 2210 { 2211 "$ref": "#/components/schemas/pointGeoJSON" 2212 }, 2213 { 2214 "$ref": "#/components/schemas/multipointGeoJSON" 2215 }, 2216 { 2217 "$ref": "#/components/schemas/linestringGeoJSON" 2218 }, 2219 { 2220 "$ref": "#/components/schemas/multilinestringGeoJSON" 2221 }, 2222 { 2223 "$ref": "#/components/schemas/polygonGeoJSON" 2224 }, 2225 { 2226 "$ref": "#/components/schemas/multipolygonGeoJSON" 2227 }, 2228 { 2229 "$ref": "#/components/schemas/geometrycollectionGeoJSON" 2230 } 2231 ] 2232 }, 2233 "geometrycollectionGeoJSON": { 2234 "properties": { 2235 "geometries": { 2236 "items": { 2237 "$ref": "#/components/schemas/geometryGeoJSON" 2238 }, 2239 "type": "array" 2240 }, 2241 "type": { 2242 "enum": [ 2243 "GeometryCollection" 2244 ], 2245 "type": "string" 2246 } 2247 }, 2248 "required": [ 2249 "geometries", 2250 "type" 2251 ], 2252 "type": "object" 2253 }, 2254 "landingPage": { 2255 "properties": { 2256 "attribution": { 2257 "description": "The `attribution` should be short and intended for presentation to a user, for example, in a corner of a map. Parts of the text can be links to other resources if additional information is needed. The string can include HTML markup.", 2258 "title": "attribution for the API", 2259 "type": "string" 2260 }, 2261 "description": { 2262 "example": "Access to data about buildings in the city of Bonn via a Web API that conforms to the OGC API Features specification.", 2263 "type": "string" 2264 }, 2265 "links": { 2266 "items": { 2267 "$ref": "#/components/schemas/link" 2268 }, 2269 "type": "array" 2270 }, 2271 "title": { 2272 "description": "While a title is not required, implementors are strongly advised to include one.", 2273 "example": "Buildings in Bonn", 2274 "title": "The title of the API.", 2275 "type": "string" 2276 } 2277 }, 2278 "required": [ 2279 "links" 2280 ], 2281 "type": "object" 2282 }, 2283 "linestringGeoJSON": { 2284 "properties": { 2285 "coordinates": { 2286 "items": { 2287 "items": { 2288 "type": "number" 2289 }, 2290 "minItems": 2, 2291 "type": "array" 2292 }, 2293 "minItems": 2, 2294 "type": "array" 2295 }, 2296 "type": { 2297 "enum": [ 2298 "LineString" 2299 ], 2300 "type": "string" 2301 } 2302 }, 2303 "required": [ 2304 "coordinates", 2305 "type" 2306 ], 2307 "type": "object" 2308 }, 2309 "link": { 2310 "properties": { 2311 "href": { 2312 "description": "Supplies the URI to a remote resource (or resource fragment).", 2313 "example": "http://data.example.com/buildings/123", 2314 "type": "string" 2315 }, 2316 "hreflang": { 2317 "description": "A hint indicating what the language of the result of dereferencing the link should be.", 2318 "example": "en", 2319 "type": "string" 2320 }, 2321 "length": { 2322 "type": "integer" 2323 }, 2324 "rel": { 2325 "description": "The type or semantics of the relation.", 2326 "example": "alternate", 2327 "type": "string" 2328 }, 2329 "templated": { 2330 "description": "This flag set to true if the link is a URL template.", 2331 "type": "boolean" 2332 }, 2333 "title": { 2334 "description": "Used to label the destination of a link such that it can be used as a human-readable identifier.", 2335 "example": "Trierer Strasse 70, 53115 Bonn", 2336 "type": "string" 2337 }, 2338 "type": { 2339 "description": "A hint indicating what the media type of the result of dereferencing the link should be.", 2340 "example": "application/geo+json", 2341 "type": "string" 2342 }, 2343 "varBase": { 2344 "description": "A base path to retrieve semantic information about the variables used in URL template.", 2345 "example": "/ogcapi/vars/", 2346 "type": "string" 2347 } 2348 }, 2349 "required": [ 2350 "href" 2351 ], 2352 "type": "object" 2353 }, 2354 "multilinestringGeoJSON": { 2355 "properties": { 2356 "coordinates": { 2357 "items": { 2358 "items": { 2359 "items": { 2360 "type": "number" 2361 }, 2362 "minItems": 2, 2363 "type": "array" 2364 }, 2365 "minItems": 2, 2366 "type": "array" 2367 }, 2368 "type": "array" 2369 }, 2370 "type": { 2371 "enum": [ 2372 "MultiLineString" 2373 ], 2374 "type": "string" 2375 } 2376 }, 2377 "required": [ 2378 "coordinates", 2379 "type" 2380 ], 2381 "type": "object" 2382 }, 2383 "multipointGeoJSON": { 2384 "properties": { 2385 "coordinates": { 2386 "items": { 2387 "items": { 2388 "type": "number" 2389 }, 2390 "minItems": 2, 2391 "type": "array" 2392 }, 2393 "type": "array" 2394 }, 2395 "type": { 2396 "enum": [ 2397 "MultiPoint" 2398 ], 2399 "type": "string" 2400 } 2401 }, 2402 "required": [ 2403 "coordinates", 2404 "type" 2405 ], 2406 "type": "object" 2407 }, 2408 "multipolygonGeoJSON": { 2409 "properties": { 2410 "coordinates": { 2411 "items": { 2412 "items": { 2413 "items": { 2414 "items": { 2415 "type": "number" 2416 }, 2417 "minItems": 2, 2418 "type": "array" 2419 }, 2420 "minItems": 4, 2421 "type": "array" 2422 }, 2423 "type": "array" 2424 }, 2425 "type": "array" 2426 }, 2427 "type": { 2428 "enum": [ 2429 "MultiPolygon" 2430 ], 2431 "type": "string" 2432 } 2433 }, 2434 "required": [ 2435 "coordinates", 2436 "type" 2437 ], 2438 "type": "object" 2439 }, 2440 "numberMatched": { 2441 "description": "The number of features of the feature type that match the selection\nparameters like `bbox`.", 2442 "example": 127, 2443 "minimum": 0, 2444 "type": "integer" 2445 }, 2446 "numberReturned": { 2447 "description": "The number of features in the feature collection.\n\nA server may omit this information in a response, if the information\nabout the number of features is not known or difficult to compute.\n\nIf the value is provided, the value shall be identical to the number\nof items in the \"features\" array.", 2448 "example": 10, 2449 "minimum": 0, 2450 "type": "integer" 2451 }, 2452 "pointGeoJSON": { 2453 "properties": { 2454 "coordinates": { 2455 "items": { 2456 "type": "number" 2457 }, 2458 "minItems": 2, 2459 "type": "array" 2460 }, 2461 "type": { 2462 "enum": [ 2463 "Point" 2464 ], 2465 "type": "string" 2466 } 2467 }, 2468 "required": [ 2469 "coordinates", 2470 "type" 2471 ], 2472 "type": "object" 2473 }, 2474 "polygonGeoJSON": { 2475 "properties": { 2476 "coordinates": { 2477 "items": { 2478 "items": { 2479 "items": { 2480 "type": "number" 2481 }, 2482 "minItems": 2, 2483 "type": "array" 2484 }, 2485 "minItems": 4, 2486 "type": "array" 2487 }, 2488 "type": "array" 2489 }, 2490 "type": { 2491 "enum": [ 2492 "Polygon" 2493 ], 2494 "type": "string" 2495 } 2496 }, 2497 "required": [ 2498 "coordinates", 2499 "type" 2500 ], 2501 "type": "object" 2502 }, 2503 "styles": { 2504 "enum": [ 2505 "default" 2506 ], 2507 "type": "string" 2508 }, 2509 "tileMatrixLimits": { 2510 "description": "The limits for an individual tile matrix of a TileSet's TileMatrixSet, as defined in the OGC 2D TileMatrixSet and TileSet Metadata Standard", 2511 "properties": { 2512 "maxTileCol": { 2513 "minimum": 0, 2514 "type": "integer" 2515 }, 2516 "maxTileRow": { 2517 "minimum": 0, 2518 "type": "integer" 2519 }, 2520 "minTileCol": { 2521 "minimum": 0, 2522 "type": "integer" 2523 }, 2524 "minTileRow": { 2525 "minimum": 0, 2526 "type": "integer" 2527 }, 2528 "tileMatrix": { 2529 "type": "string" 2530 } 2531 }, 2532 "required": [ 2533 "tileMatrix", 2534 "minTileRow", 2535 "maxTileRow", 2536 "minTileCol", 2537 "maxTileCol" 2538 ], 2539 "title": "TileMatrixLimits", 2540 "type": "object" 2541 }, 2542 "tileMatrixSet": { 2543 "description": "A definition of a tile matrix set following the Tile Matrix Set standard. For tileset metadata, such a description (in `tileMatrixSet` property) is only required for offline use, as an alternative to a link with a `http://www.opengis.net/def/rel/ogc/1.0/tiling-scheme` relation type.", 2544 "properties": { 2545 "boundingBox": { 2546 "allOf": [ 2547 { 2548 "description": "Minimum bounding rectangle surrounding the tile matrix set, in the supported CRS" 2549 }, 2550 { 2551 "$ref": "#/components/schemas/2DBoundingBox" 2552 } 2553 ] 2554 }, 2555 "crs": { 2556 "allOf": [ 2557 { 2558 "description": "Coordinate Reference System (CRS)" 2559 }, 2560 { 2561 "$ref": "#/components/schemas/crs" 2562 } 2563 ] 2564 }, 2565 "description": { 2566 "description": "Brief narrative description of this tile matrix set, normally available for display to a human", 2567 "type": "string" 2568 }, 2569 "id": { 2570 "description": "Tile matrix set identifier. Implementation of 'identifier'", 2571 "type": "string" 2572 }, 2573 "keywords": { 2574 "description": "Unordered list of one or more commonly used or formalized word(s) or phrase(s) used to describe this tile matrix set", 2575 "items": { 2576 "type": "string" 2577 }, 2578 "type": "array" 2579 }, 2580 "orderedAxes": { 2581 "items": { 2582 "type": "string" 2583 }, 2584 "minItems": 1, 2585 "type": "array" 2586 }, 2587 "tileMatrices": { 2588 "description": "Describes scale levels and its tile matrices", 2589 "items": { 2590 "description": "A tile matrix, usually corresponding to a particular zoom level of a TileMatrixSet.", 2591 "properties": { 2592 "cellSize": { 2593 "description": "Cell size of this tile matrix", 2594 "type": "number" 2595 }, 2596 "cornerOfOrigin": { 2597 "default": "topLeft", 2598 "description": "The corner of the tile matrix (_topLeft_ or _bottomLeft_) used as the origin for numbering tile rows and columns. This corner is also a corner of the (0, 0) tile.", 2599 "enum": [ 2600 "topLeft", 2601 "bottomLeft" 2602 ], 2603 "type": "string" 2604 }, 2605 "description": { 2606 "description": "Brief narrative description of this tile matrix set, normally available for display to a human", 2607 "type": "string" 2608 }, 2609 "id": { 2610 "description": "Identifier selecting one of the scales defined in the TileMatrixSet and representing the scaleDenominator the tile. Implementation of 'identifier'", 2611 "type": "string" 2612 }, 2613 "keywords": { 2614 "description": "Unordered list of one or more commonly used or formalized word(s) or phrase(s) used to describe this dataset", 2615 "items": { 2616 "type": "string" 2617 }, 2618 "type": "array" 2619 }, 2620 "matrixHeight": { 2621 "description": "Width of the matrix (number of tiles in width)", 2622 "format": "integer", 2623 "minimum": 1, 2624 "multipleOf": 1, 2625 "type": "number" 2626 }, 2627 "matrixWidth": { 2628 "description": "Height of the matrix (number of tiles in height)", 2629 "format": "integer", 2630 "minimum": 1, 2631 "multipleOf": 1, 2632 "type": "number" 2633 }, 2634 "pointOfOrigin": { 2635 "allOf": [ 2636 { 2637 "description": "Precise position in CRS coordinates of the corner of origin (e.g. the top-left corner) for this tile matrix. This position is also a corner of the (0, 0) tile. In previous version, this was 'topLeftCorner' and 'cornerOfOrigin' did not exist." 2638 }, 2639 { 2640 "$ref": "#/components/schemas/2DPoint" 2641 } 2642 ] 2643 }, 2644 "scaleDenominator": { 2645 "description": "Scale denominator of this tile matrix", 2646 "type": "number" 2647 }, 2648 "tileHeight": { 2649 "description": "Height of each tile of this tile matrix in pixels", 2650 "format": "integer", 2651 "minimum": 1, 2652 "multipleOf": 1, 2653 "type": "number" 2654 }, 2655 "tileWidth": { 2656 "description": "Width of each tile of this tile matrix in pixels", 2657 "format": "integer", 2658 "minimum": 1, 2659 "multipleOf": 1, 2660 "type": "number" 2661 }, 2662 "title": { 2663 "description": "Title of this tile matrix, normally used for display to a human", 2664 "type": "string" 2665 }, 2666 "variableMatrixWidths": { 2667 "description": "Describes the rows that has variable matrix width", 2668 "items": { 2669 "description": "Variable Matrix Width data structure", 2670 "properties": { 2671 "coalesce": { 2672 "description": "Number of tiles in width that coalesce in a single tile for these rows", 2673 "format": "integer", 2674 "minimum": 2, 2675 "multipleOf": 1, 2676 "type": "number" 2677 }, 2678 "maxTileRow": { 2679 "description": "Last tile row where the coalescence factor applies for this tilematrix", 2680 "format": "integer", 2681 "minimum": 0, 2682 "multipleOf": 1, 2683 "type": "number" 2684 }, 2685 "minTileRow": { 2686 "description": "First tile row where the coalescence factor applies for this tilematrix", 2687 "format": "integer", 2688 "minimum": 0, 2689 "multipleOf": 1, 2690 "type": "number" 2691 } 2692 }, 2693 "required": [ 2694 "coalesce", 2695 "minTileRow", 2696 "maxTileRow" 2697 ], 2698 "type": "object" 2699 }, 2700 "type": "array" 2701 } 2702 }, 2703 "required": [ 2704 "id", 2705 "scaleDenominator", 2706 "cellSize", 2707 "pointOfOrigin", 2708 "tileWidth", 2709 "tileHeight", 2710 "matrixWidth", 2711 "matrixHeight" 2712 ], 2713 "type": "object" 2714 }, 2715 "type": "array" 2716 }, 2717 "title": { 2718 "description": "Title of this tile matrix set, normally used for display to a human", 2719 "type": "string" 2720 }, 2721 "uri": { 2722 "description": "Reference to an official source for this tileMatrixSet", 2723 "format": "uri", 2724 "type": "string" 2725 }, 2726 "wellKnownScaleSet": { 2727 "description": "Reference to a well-known scale set", 2728 "format": "uri", 2729 "type": "string" 2730 } 2731 }, 2732 "required": [ 2733 "crs", 2734 "tileMatrices" 2735 ], 2736 "title": "Tile Matrix Set Definition", 2737 "type": "object" 2738 }, 2739 "tileMatrixSet-item": { 2740 "description": "A minimal tile matrix set element for use within a list of tile matrix sets linking to a full definition.", 2741 "properties": { 2742 "crs": { 2743 "allOf": [ 2744 { 2745 "description": "Coordinate Reference System (CRS)" 2746 }, 2747 { 2748 "$ref": "#/components/schemas/crs" 2749 } 2750 ] 2751 }, 2752 "id": { 2753 "description": "Optional local tile matrix set identifier, e.g. for use as unspecified `{tileMatrixSetId}` parameter. Implementation of 'identifier'", 2754 "type": "string" 2755 }, 2756 "links": { 2757 "description": "Links to related resources. A 'self' link to the tile matrix set definition is required.", 2758 "items": { 2759 "$ref": "#/components/schemas/link" 2760 }, 2761 "type": "array" 2762 }, 2763 "title": { 2764 "description": "Title of this tile matrix set, normally used for display to a human", 2765 "type": "string" 2766 }, 2767 "uri": { 2768 "description": "Reference to an official source for this tileMatrixSet", 2769 "format": "uri", 2770 "type": "string" 2771 } 2772 }, 2773 "required": [ 2774 "links" 2775 ], 2776 "title": "Tile Matrix Set Item", 2777 "type": "object" 2778 }, 2779 "tileMatrixSets": { 2780 "enum": [ 2781 "WebMercatorQuad", 2782 "WorldCRS84Quad", 2783 "GNOSISGlobalGrid", 2784 "WorldMercatorWGS84Quad" 2785 ], 2786 "type": "string" 2787 }, 2788 "tileSet": { 2789 "description": "A resource describing a tileset based on the OGC TileSet Metadata Standard. At least one of the 'TileMatrixSet', or a link with 'rel' http://www.opengis.net/def/rel/ogc/1.0/tiling-scheme", 2790 "properties": { 2791 "accessConstraints": { 2792 "default": "unclassified", 2793 "description": "Restrictions on the availability of the Tile Set that the user needs to be aware of before using or redistributing the Tile Set", 2794 "enum": [ 2795 "unclassified", 2796 "restricted", 2797 "confidential", 2798 "secret", 2799 "topSecret" 2800 ], 2801 "type": "string" 2802 }, 2803 "attribution": { 2804 "description": "Short reference to recognize the author or provider", 2805 "type": "string" 2806 }, 2807 "boundingBox": { 2808 "allOf": [ 2809 { 2810 "description": "Minimum bounding rectangle surrounding the tile matrix set, in the supported CRS" 2811 }, 2812 { 2813 "$ref": "#/components/schemas/2DBoundingBox" 2814 } 2815 ] 2816 }, 2817 "centerPoint": { 2818 "allOf": [ 2819 { 2820 "description": "Location of a tile that nicely represents the tileset. Implementations may use this center value to set the default location or to present a representative tile in a user interface" 2821 }, 2822 { 2823 "properties": { 2824 "cellSize": { 2825 "description": "Cell size of the tile matrix selected", 2826 "type": "number" 2827 }, 2828 "coordinates": { 2829 "items": { 2830 "type": "number" 2831 }, 2832 "maxItems": 2, 2833 "minItems": 2, 2834 "type": "array" 2835 }, 2836 "crs": { 2837 "allOf": [ 2838 { 2839 "description": "Coordinate Reference System (CRS) of the coordinates" 2840 }, 2841 { 2842 "$ref": "#/components/schemas/crs" 2843 } 2844 ] 2845 }, 2846 "scaleDenominator": { 2847 "description": "Scale denominator of the tile matrix selected", 2848 "type": "number" 2849 }, 2850 "tileMatrix": { 2851 "description": "TileMatrix identifier associated with the scaleDenominator", 2852 "type": "string" 2853 } 2854 }, 2855 "required": [ 2856 "coordinates" 2857 ], 2858 "type": "object" 2859 } 2860 ] 2861 }, 2862 "created": { 2863 "allOf": [ 2864 { 2865 "description": "When the Tile Set was first produced" 2866 }, 2867 { 2868 "$ref": "#/components/schemas/timeStamp" 2869 } 2870 ] 2871 }, 2872 "crs": { 2873 "allOf": [ 2874 { 2875 "description": "Coordinate Reference System (CRS)" 2876 }, 2877 { 2878 "$ref": "#/components/schemas/crs" 2879 } 2880 ] 2881 }, 2882 "dataType": { 2883 "allOf": [ 2884 { 2885 "description": "Type of data represented in the tileset" 2886 }, 2887 { 2888 "$ref": "#/components/schemas/dataType" 2889 } 2890 ] 2891 }, 2892 "description": { 2893 "description": "Brief narrative description of this tile set", 2894 "type": "string" 2895 }, 2896 "epoch": { 2897 "description": "Epoch of the Coordinate Reference System (CRS)", 2898 "type": "number" 2899 }, 2900 "keywords": { 2901 "description": "keywords about this tileset", 2902 "items": { 2903 "type": "string" 2904 }, 2905 "type": "array" 2906 }, 2907 "layers": { 2908 "items": { 2909 "properties": { 2910 "attribution": { 2911 "description": "Short reference to recognize the author or provider", 2912 "type": "string" 2913 }, 2914 "boundingBox": { 2915 "allOf": [ 2916 { 2917 "description": "Minimum bounding rectangle surrounding the layer" 2918 }, 2919 { 2920 "$ref": "#/components/schemas/2DBoundingBox" 2921 } 2922 ] 2923 }, 2924 "created": { 2925 "allOf": [ 2926 { 2927 "description": "When the layer was first produced" 2928 }, 2929 { 2930 "$ref": "#/components/schemas/timeStamp" 2931 } 2932 ] 2933 }, 2934 "crs": { 2935 "allOf": [ 2936 { 2937 "description": "Coordinate Reference System (CRS)" 2938 }, 2939 { 2940 "$ref": "#/components/schemas/crs" 2941 } 2942 ] 2943 }, 2944 "dataType": { 2945 "allOf": [ 2946 { 2947 "description": "Type of data represented in the layer" 2948 }, 2949 { 2950 "$ref": "#/components/schemas/dataType" 2951 } 2952 ] 2953 }, 2954 "description": { 2955 "description": "Brief narrative description of this tile matrix set, normally available for display to a human", 2956 "type": "string" 2957 }, 2958 "epoch": { 2959 "description": "Epoch of the Coordinate Reference System (CRS)", 2960 "type": "number" 2961 }, 2962 "featureType": { 2963 "description": "Feature type identifier. Only applicable to layers of datatype 'geometries'", 2964 "type": "string" 2965 }, 2966 "geoDataClasses": { 2967 "description": "URI identifying a class of data contained in this layer (useful to determine compatibility with styles or processes)", 2968 "items": { 2969 "type": "string" 2970 }, 2971 "type": "array" 2972 }, 2973 "geometryDimension": { 2974 "description": "The geometry dimension of the features shown in this layer (0: points, 1: curves, 2: surfaces, 3: solids), unspecified: mixed or unknown", 2975 "maximum": 3, 2976 "minimum": 0, 2977 "type": "integer" 2978 }, 2979 "id": { 2980 "description": "Unique identifier of the Layer. Implementation of 'identifier'", 2981 "type": "string" 2982 }, 2983 "keywords": { 2984 "description": "Unordered list of one or more commonly used or formalized word(s) or phrase(s) used to describe this layer", 2985 "type": "string" 2986 }, 2987 "license": { 2988 "description": "License applicable to the tiles", 2989 "type": "string" 2990 }, 2991 "links": { 2992 "description": "Links related to this layer. Possible link 'rel' values are: 'geodata' for a URL pointing to the collection of geospatial data.", 2993 "items": { 2994 "$ref": "#/components/schemas/link" 2995 }, 2996 "minItems": 1, 2997 "type": "array" 2998 }, 2999 "maxCellSize": { 3000 "description": "Maximum cell size for usage of the layer", 3001 "type": "number" 3002 }, 3003 "maxScaleDenominator": { 3004 "description": "Maximum scale denominator for usage of the layer", 3005 "type": "number" 3006 }, 3007 "maxTileMatrix": { 3008 "description": "TileMatrix identifier associated with the minScaleDenominator", 3009 "type": "string" 3010 }, 3011 "minCellSize": { 3012 "description": "Minimum cell size for usage of the layer", 3013 "type": "number" 3014 }, 3015 "minScaleDenominator": { 3016 "description": "Minimum scale denominator for usage of the layer", 3017 "type": "number" 3018 }, 3019 "minTileMatrix": { 3020 "description": "TileMatrix identifier associated with the maxScaleDenominator", 3021 "type": "string" 3022 }, 3023 "pointOfContact": { 3024 "description": "Useful information to contact the authors or custodians for the layer (e.g. e-mail address, a physical address, phone numbers, etc)", 3025 "type": "string" 3026 }, 3027 "propertiesSchema": { 3028 "allOf": [ 3029 { 3030 "description": "Properties represented by the features in this layer. Can be the attributes of a feature dataset (datatype=geometries) or the rangeType of a coverage (datatype=coverage)" 3031 }, 3032 { 3033 "description": "Attributes of the features or rangetypes of a coverage. Defined by a subset of the JSON Schema for the properties of a feature", 3034 "properties": { 3035 "properties": { 3036 "additionalProperties": { 3037 "description": "No property names are defined but any property name they should be described by JSON Schema. So 'additionalProperties' implements 'name'.", 3038 "properties": { 3039 "contentMediaType": { 3040 "description": "Implements 'mediaType'", 3041 "type": "string" 3042 }, 3043 "description": { 3044 "description": "Implements 'description'", 3045 "type": "string" 3046 }, 3047 "enum": { 3048 "description": "Implements 'acceptedValues'", 3049 "items": {}, 3050 "minItems": 1, 3051 "type": "array", 3052 "uniqueItems": true 3053 }, 3054 "exclusiveMaximum": { 3055 "description": "Implements 'range'", 3056 "type": "number" 3057 }, 3058 "exclusiveMinimum": { 3059 "description": "Implements 'range'", 3060 "type": "number" 3061 }, 3062 "format": { 3063 "description": "Complements implementation of 'type'", 3064 "type": "string" 3065 }, 3066 "maxItems": { 3067 "description": "Implements 'upperMultiplicity'", 3068 "minimum": 0, 3069 "type": "integer" 3070 }, 3071 "maximum": { 3072 "description": "Implements 'range'", 3073 "type": "number" 3074 }, 3075 "minItems": { 3076 "default": 0, 3077 "description": "Implements 'lowerMultiplicity'", 3078 "minimum": 0, 3079 "type": "integer" 3080 }, 3081 "minimum": { 3082 "description": "Implements 'range'", 3083 "type": "number" 3084 }, 3085 "observedProperty": { 3086 "type": "string" 3087 }, 3088 "observedPropertyURI": { 3089 "format": "uri", 3090 "type": "string" 3091 }, 3092 "pattern": { 3093 "format": "regex", 3094 "type": "string" 3095 }, 3096 "title": { 3097 "type": "string" 3098 }, 3099 "type": { 3100 "enum": [ 3101 "array", 3102 "boolean", 3103 "integer", 3104 "null", 3105 "number", 3106 "object", 3107 "string" 3108 ], 3109 "type": "string" 3110 }, 3111 "uom": { 3112 "type": "string" 3113 }, 3114 "uomURI": { 3115 "format": "uri", 3116 "type": "string" 3117 } 3118 }, 3119 "type": "object" 3120 }, 3121 "default": {}, 3122 "type": "object" 3123 }, 3124 "required": { 3125 "description": "Implements 'multiplicity' by citing property 'name' defined as 'additionalProperties'", 3126 "items": { 3127 "type": "string" 3128 }, 3129 "minItems": 1, 3130 "type": "array" 3131 }, 3132 "type": { 3133 "enum": [ 3134 "object" 3135 ], 3136 "type": "string" 3137 } 3138 }, 3139 "required": [ 3140 "type", 3141 "properties" 3142 ], 3143 "type": "object" 3144 } 3145 ] 3146 }, 3147 "publisher": { 3148 "description": "Organization or individual responsible for making the layer available", 3149 "type": "string" 3150 }, 3151 "style": { 3152 "allOf": [ 3153 { 3154 "description": "Style used to generate the layer in the tileset" 3155 }, 3156 { 3157 "$ref": "#/components/schemas/tileSet/properties/style/allOf/1" 3158 } 3159 ] 3160 }, 3161 "theme": { 3162 "description": "Category where the layer can be grouped", 3163 "type": "string" 3164 }, 3165 "title": { 3166 "description": "Title of this tile matrix set, normally used for display to a human", 3167 "type": "string" 3168 }, 3169 "updated": { 3170 "allOf": [ 3171 { 3172 "description": "Last layer change/revision" 3173 }, 3174 { 3175 "$ref": "#/components/schemas/timeStamp" 3176 } 3177 ] 3178 } 3179 }, 3180 "required": [ 3181 "id", 3182 "dataType" 3183 ], 3184 "type": "object" 3185 }, 3186 "minItems": 1, 3187 "type": "array" 3188 }, 3189 "license": { 3190 "description": "License applicable to the tiles", 3191 "type": "string" 3192 }, 3193 "links": { 3194 "description": "Links to related resources. Possible link 'rel' values are: 'http://www.opengis.net/def/rel/ogc/1.0/dataset' for a URL pointing to the dataset, 'item' for a URL template to get a tile; 'alternate' for a URL pointing to another representation of the TileSetMetadata (e.g a TileJSON file); 'http://www.opengis.net/def/rel/ogc/1.0/tiling-scheme' for a definition of the TileMatrixSet; 'http://www.opengis.net/def/rel/ogc/1.0/geodata' for pointing to a single collection (if the tileset represents a single collection)", 3195 "items": { 3196 "$ref": "#/components/schemas/link" 3197 }, 3198 "type": "array" 3199 }, 3200 "mediaTypes": { 3201 "description": "Media types available for the tiles", 3202 "items": { 3203 "type": "string" 3204 }, 3205 "type": "array" 3206 }, 3207 "pointOfContact": { 3208 "description": "Useful information to contact the authors or custodians for the Tile Set", 3209 "type": "string" 3210 }, 3211 "style": { 3212 "allOf": [ 3213 { 3214 "description": "Style involving all layers used to generate the tileset" 3215 }, 3216 { 3217 "properties": { 3218 "description": { 3219 "description": "Brief narrative description of this style", 3220 "type": "string" 3221 }, 3222 "id": { 3223 "description": "An identifier for this style. Implementation of 'identifier'", 3224 "type": "string" 3225 }, 3226 "keywords": { 3227 "description": "keywords about this style", 3228 "items": { 3229 "type": "string" 3230 }, 3231 "type": "array" 3232 }, 3233 "links": { 3234 "description": "Links to style related resources. Possible link 'rel' values are: 'style' for a URL pointing to the style description, 'styleSpec' for a URL pointing to the specification or standard used to define the style.", 3235 "items": { 3236 "$ref": "#/components/schemas/link" 3237 }, 3238 "minItems": 1, 3239 "type": "array" 3240 }, 3241 "title": { 3242 "description": "A title for this style", 3243 "type": "string" 3244 } 3245 }, 3246 "required": [ 3247 "id" 3248 ], 3249 "type": "object" 3250 } 3251 ] 3252 }, 3253 "tileMatrixSetLimits": { 3254 "description": "Limits for the TileRow and TileCol values for each TileMatrix in the tileMatrixSet. If missing, there are no limits other that the ones imposed by the TileMatrixSet. If present the TileMatrices listed are limited and the rest not available at all", 3255 "items": { 3256 "$ref": "#/components/schemas/tileMatrixLimits" 3257 }, 3258 "type": "array" 3259 }, 3260 "tileMatrixSetURI": { 3261 "description": "Reference to a Tile Matrix Set on an offical source for Tile Matrix Sets such as the OGC NA definition server (http://www.opengis.net/def/tms/). Required if the tile matrix set is registered on an open official source.", 3262 "format": "uri", 3263 "type": "string" 3264 }, 3265 "title": { 3266 "description": "A title for this tileset", 3267 "type": "string" 3268 }, 3269 "updated": { 3270 "allOf": [ 3271 { 3272 "description": "Last Tile Set change/revision" 3273 }, 3274 { 3275 "$ref": "#/components/schemas/timeStamp" 3276 } 3277 ] 3278 }, 3279 "version": { 3280 "description": "Version of the Tile Set. Changes if the data behind the tiles has been changed", 3281 "type": "string" 3282 } 3283 }, 3284 "required": [ 3285 "dataType", 3286 "crs", 3287 "links" 3288 ], 3289 "title": "Tile Set Metadata", 3290 "type": "object" 3291 }, 3292 "tileSet-item": { 3293 "description": "A minimal tileset element for use within a list of tilesets linking to full description of those tilesets.", 3294 "properties": { 3295 "crs": { 3296 "allOf": [ 3297 { 3298 "description": "Coordinate Reference System (CRS)" 3299 }, 3300 { 3301 "$ref": "#/components/schemas/crs" 3302 } 3303 ] 3304 }, 3305 "dataType": { 3306 "allOf": [ 3307 { 3308 "description": "Type of data represented in the tileset" 3309 }, 3310 { 3311 "$ref": "#/components/schemas/dataType" 3312 } 3313 ] 3314 }, 3315 "links": { 3316 "description": "Links to related resources. A 'self' link to the tileset as well as a 'http://www.opengis.net/def/rel/ogc/1.0/tiling-scheme' link to a definition of the TileMatrixSet are required.", 3317 "items": { 3318 "$ref": "#/components/schemas/link" 3319 }, 3320 "type": "array" 3321 }, 3322 "tileMatrixSetURI": { 3323 "description": "Reference to a Tile Matrix Set on an offical source for Tile Matrix Sets such as the OGC NA definition server (http://www.opengis.net/def/tms/). Required if the tile matrix set is registered on an open official source.", 3324 "format": "uri", 3325 "type": "string" 3326 }, 3327 "title": { 3328 "description": "A title for this tileset", 3329 "type": "string" 3330 } 3331 }, 3332 "required": [ 3333 "dataType", 3334 "links", 3335 "crs" 3336 ], 3337 "title": "Tile Set Metadata item", 3338 "type": "object" 3339 }, 3340 "timeStamp": { 3341 "description": "This property indicates the time and date when the response was generated.", 3342 "example": "2017-08-17T08:05:32Z", 3343 "format": "date-time", 3344 "type": "string" 3345 }, 3346 "vectorTiles-collections": { 3347 "enum": [ 3348 "NaturalEarth:cultural:ne_10m_admin_0_countries", 3349 "NaturalEarth:physical:bathymetry" 3350 ], 3351 "type": "string" 3352 } 3353 } 3354 }, 3355 "info": { 3356 "contact": { 3357 "email": "standards-team@ogc.org", 3358 "name": "Open Geospatial Consortium (OGC)", 3359 "url": "https://www.ogc.org/contacts" 3360 }, 3361 "description": "Common components used in the\n[\"OGC API - Features - Part 1: Core corrigendum standard\"](https://docs.opengeospatial.org/is/17-069r4/17-069r4.html).\n\nOGC API - Features - Part 1: Core corrigendum 1.0.1 is an OGC Standard.\nCopyright (c) 2022 Open Geospatial Consortium.\nTo obtain additional rights of use, visit http://www.opengeospatial.org/legal/ .\n\nThis is an informative document. The building blocks in this document are also available on the\n[OGC](http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/ogcapi-features-1.yaml) schema repository.", 3362 "license": { 3363 "name": "OGC License", 3364 "url": "http://www.opengeospatial.org/legal/" 3365 }, 3366 "title": "Building Blocks specified in the OGC API - Features - Part 1: Core corrigendum standard", 3367 "version": "1.0.1", 3368 "x-logo": { 3369 "url": "https://www.ogc.org/pub/www/files/OGC_Logo_2D_Blue_x_0_0.png" 3370 } 3371 }, 3372 "openapi": "3.0.2", 3373 "paths": { 3374 "/": { 3375 "get": { 3376 "description": "The landing page provides links to the API definition, the conformance\nstatements and to the feature collections in this dataset.", 3377 "operationId": "getLandingPage", 3378 "parameters": [ 3379 { 3380 "$ref": "#/components/parameters/f-metadata" 3381 } 3382 ], 3383 "responses": { 3384 "200": { 3385 "$ref": "#/components/responses/LandingPage", 3386 "content": { 3387 "application/json": { 3388 "example": { 3389 "description": "Access to data about buildings in the city of Bonn via a Web API that conforms to the OGC API Features specification.", 3390 "links": [ 3391 { 3392 "href": "http://data.example.org/", 3393 "rel": "self", 3394 "title": "this document", 3395 "type": "application/json" 3396 }, 3397 { 3398 "href": "http://data.example.org/api", 3399 "rel": "service-desc", 3400 "title": "the API definition", 3401 "type": "application/vnd.oai.openapi+json;version=3.0" 3402 }, 3403 { 3404 "href": "http://data.example.org/api.html", 3405 "rel": "service-doc", 3406 "title": "the API documentation", 3407 "type": "text/html" 3408 }, 3409 { 3410 "href": "http://data.example.org/conformance", 3411 "rel": "conformance", 3412 "title": "OGC API conformance classes implemented by this server", 3413 "type": "application/json" 3414 }, 3415 { 3416 "href": "http://data.example.org/collections", 3417 "rel": "data", 3418 "title": "Information about the feature collections", 3419 "type": "application/json" 3420 } 3421 ], 3422 "title": "Buildings in Bonn" 3423 }, 3424 "schema": { 3425 "$ref": "#/components/schemas/landingPage" 3426 } 3427 }, 3428 "text/html": { 3429 "schema": { 3430 "type": "string" 3431 } 3432 } 3433 }, 3434 "description": "The landing page provides links to the API definition\n(link relations `service-desc` and `service-doc`),\nthe Conformance declaration (path `/conformance`,\nlink relation `conformance`), and the Feature\nCollections (path `/collections`, link relation\n`data`)." 3435 }, 3436 "406": { 3437 "$ref": "#/components/responses/NotAcceptable" 3438 }, 3439 "500": { 3440 "$ref": "#/components/responses/ServerError", 3441 "content": { 3442 "application/json": { 3443 "schema": { 3444 "$ref": "#/components/schemas/exception" 3445 } 3446 }, 3447 "text/html": { 3448 "schema": { 3449 "type": "string" 3450 } 3451 } 3452 }, 3453 "description": "A server error occurred." 3454 } 3455 }, 3456 "summary": "landing page", 3457 "tags": [ 3458 "Capabilities" 3459 ] 3460 } 3461 }, 3462 "/api": { 3463 "get": { 3464 "operationId": "getAPI", 3465 "parameters": [ 3466 { 3467 "$ref": "#/components/parameters/f-metadata" 3468 } 3469 ], 3470 "responses": { 3471 "200": { 3472 "$ref": "#/components/responses/API" 3473 }, 3474 "406": { 3475 "$ref": "#/components/responses/NotAcceptable" 3476 }, 3477 "500": { 3478 "$ref": "#/components/responses/ServerError" 3479 } 3480 }, 3481 "summary": "Retrieve this API definition.", 3482 "tags": [ 3483 "API" 3484 ] 3485 } 3486 }, 3487 "/api/all-collections": { 3488 "get": { 3489 "operationId": "getAPICollections", 3490 "parameters": [ 3491 { 3492 "$ref": "#/components/parameters/f-metadata" 3493 } 3494 ], 3495 "responses": { 3496 "200": { 3497 "$ref": "#/components/responses/Enumeration" 3498 }, 3499 "404": { 3500 "$ref": "#/components/responses/NotFound" 3501 }, 3502 "406": { 3503 "$ref": "#/components/responses/NotAcceptable" 3504 }, 3505 "500": { 3506 "$ref": "#/components/responses/ServerError" 3507 } 3508 }, 3509 "summary": "Retrieve the list of collections available from this API implementation \u0026 deployment.", 3510 "tags": [ 3511 "API" 3512 ] 3513 } 3514 }, 3515 "/api/coverage-collections": { 3516 "get": { 3517 "operationId": "getAPICoverageCollections", 3518 "parameters": [ 3519 { 3520 "$ref": "#/components/parameters/f-metadata" 3521 } 3522 ], 3523 "responses": { 3524 "200": { 3525 "$ref": "#/components/responses/Enumeration" 3526 }, 3527 "404": { 3528 "$ref": "#/components/responses/NotFound" 3529 }, 3530 "406": { 3531 "$ref": "#/components/responses/NotAcceptable" 3532 }, 3533 "500": { 3534 "$ref": "#/components/responses/ServerError" 3535 } 3536 }, 3537 "summary": "Retrieve the list of coverages collections available from this API implementation \u0026 deployment.", 3538 "tags": [ 3539 "API" 3540 ] 3541 } 3542 }, 3543 "/api/styles": { 3544 "get": { 3545 "operationId": "getAPIStyles", 3546 "parameters": [ 3547 { 3548 "$ref": "#/components/parameters/f-metadata" 3549 } 3550 ], 3551 "responses": { 3552 "200": { 3553 "$ref": "#/components/responses/Enumeration" 3554 }, 3555 "404": { 3556 "$ref": "#/components/responses/NotFound" 3557 }, 3558 "406": { 3559 "$ref": "#/components/responses/NotAcceptable" 3560 }, 3561 "500": { 3562 "$ref": "#/components/responses/ServerError" 3563 } 3564 }, 3565 "summary": "Retrieve the list of dataset styles available from this API implementation \u0026 deployment.", 3566 "tags": [ 3567 "API" 3568 ] 3569 } 3570 }, 3571 "/api/tileMatrixSets": { 3572 "get": { 3573 "operationId": "getAPITileMatrixSets", 3574 "parameters": [ 3575 { 3576 "$ref": "#/components/parameters/f-metadata" 3577 } 3578 ], 3579 "responses": { 3580 "200": { 3581 "$ref": "#/components/responses/Enumeration" 3582 }, 3583 "404": { 3584 "$ref": "#/components/responses/NotFound" 3585 }, 3586 "406": { 3587 "$ref": "#/components/responses/NotAcceptable" 3588 }, 3589 "500": { 3590 "$ref": "#/components/responses/ServerError" 3591 } 3592 }, 3593 "summary": "Retrieve the list of shared TileMatrixSets available from this API implementation \u0026 deployment.", 3594 "tags": [ 3595 "API" 3596 ] 3597 } 3598 }, 3599 "/api/vectorTiles-collections": { 3600 "get": { 3601 "operationId": "getAPIVectorTileCollections", 3602 "parameters": [ 3603 { 3604 "$ref": "#/components/parameters/f-metadata" 3605 } 3606 ], 3607 "responses": { 3608 "200": { 3609 "$ref": "#/components/responses/Enumeration" 3610 }, 3611 "404": { 3612 "$ref": "#/components/responses/NotFound" 3613 }, 3614 "406": { 3615 "$ref": "#/components/responses/NotAcceptable" 3616 }, 3617 "500": { 3618 "$ref": "#/components/responses/ServerError" 3619 } 3620 }, 3621 "summary": "Retrieve the list of collections supporting vector tiles available from this API implementation \u0026 deployment.", 3622 "tags": [ 3623 "API" 3624 ] 3625 } 3626 }, 3627 "/collections": { 3628 "get": { 3629 "operationId": "getCollections", 3630 "parameters": [ 3631 { 3632 "$ref": "#/components/parameters/datetime" 3633 }, 3634 { 3635 "description": "Only features that have a geometry that intersects the bounding box are selected. The bounding box is provided as four or six numbers, depending on whether the coordinate reference system includes a vertical axis (height or depth):\n* Lower left corner, coordinate axis 1 * Lower left corner, coordinate axis 2 * Minimum value, coordinate axis 3 (optional) * Upper right corner, coordinate axis 1 * Upper right corner, coordinate axis 2 * Maximum value, coordinate axis 3 (optional)\nThe coordinate reference system of the values is WGS 84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84) unless a different coordinate reference system is specified in the parameter `bbox-crs`.\nFor WGS 84 longitude/latitude the values are in most cases the sequence of minimum longitude, minimum latitude, maximum longitude and maximum latitude. However, in cases where the box spans the antimeridian the first value (west-most box edge) is larger than the third value (east-most box edge).\nIf the vertical axis is included, the third and the sixth number are the bottom and the top of the 3-dimensional bounding box.\nIf a feature has multiple spatial geometry properties, it is the decision of the server whether only a single spatial geometry property is used to determine the extent or all relevant geometries.", 3636 "explode": false, 3637 "in": "query", 3638 "name": "bbox", 3639 "required": false, 3640 "schema": { 3641 "items": { 3642 "format": "double", 3643 "type": "number" 3644 }, 3645 "oneOf": [ 3646 { 3647 "maxItems": 4, 3648 "minItems": 4 3649 }, 3650 { 3651 "maxItems": 6, 3652 "minItems": 6 3653 } 3654 ], 3655 "type": "array" 3656 }, 3657 "style": "form" 3658 }, 3659 { 3660 "description": "The optional limit parameter limits the number of collections that are presented in the response document.\nOnly items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted.\n* Minimum = 1 * Maximum = 10000 * Default = 10", 3661 "explode": false, 3662 "in": "query", 3663 "name": "limit", 3664 "required": false, 3665 "schema": { 3666 "default": 10, 3667 "maximum": 10000, 3668 "minimum": 1, 3669 "type": "integer" 3670 }, 3671 "style": "form" 3672 }, 3673 { 3674 "$ref": "#/components/parameters/f-metadata" 3675 } 3676 ], 3677 "responses": { 3678 "200": { 3679 "$ref": "#/components/responses/CollectionsList", 3680 "content": { 3681 "application/json": { 3682 "example": { 3683 "collections": [ 3684 { 3685 "description": "Buildings in the city of Bonn.", 3686 "extent": { 3687 "spatial": { 3688 "bbox": [ 3689 [ 3690 7.01, 3691 50.63, 3692 7.22, 3693 50.78 3694 ] 3695 ] 3696 }, 3697 "temporal": { 3698 "interval": [ 3699 [ 3700 "2010-02-15T12:34:56Z", 3701 null 3702 ] 3703 ] 3704 } 3705 }, 3706 "id": "buildings", 3707 "links": [ 3708 { 3709 "href": "http://data.example.org/collections/buildings/items", 3710 "rel": "items", 3711 "title": "Buildings", 3712 "type": "application/geo+json" 3713 }, 3714 { 3715 "href": "http://data.example.org/collections/buildings/items.html", 3716 "rel": "items", 3717 "title": "Buildings", 3718 "type": "text/html" 3719 }, 3720 { 3721 "href": "https://creativecommons.org/publicdomain/zero/1.0/", 3722 "rel": "license", 3723 "title": "CC0-1.0", 3724 "type": "text/html" 3725 }, 3726 { 3727 "href": "https://creativecommons.org/publicdomain/zero/1.0/rdf", 3728 "rel": "license", 3729 "title": "CC0-1.0", 3730 "type": "application/rdf+xml" 3731 } 3732 ], 3733 "title": "Buildings" 3734 } 3735 ], 3736 "links": [ 3737 { 3738 "href": "http://data.example.org/collections.json", 3739 "rel": "self", 3740 "title": "this document", 3741 "type": "application/json" 3742 }, 3743 { 3744 "href": "http://data.example.org/collections.html", 3745 "rel": "alternate", 3746 "title": "this document as HTML", 3747 "type": "text/html" 3748 }, 3749 { 3750 "href": "http://schemas.example.org/1.0/buildings.xsd", 3751 "rel": "describedby", 3752 "title": "GML application schema for Acme Corporation building data", 3753 "type": "application/xml" 3754 }, 3755 { 3756 "href": "http://download.example.org/buildings.gpkg", 3757 "length": 472546, 3758 "rel": "enclosure", 3759 "title": "Bulk download (GeoPackage)", 3760 "type": "application/geopackage+sqlite3" 3761 } 3762 ] 3763 }, 3764 "schema": { 3765 "$ref": "#/components/schemas/collections" 3766 } 3767 }, 3768 "text/html": { 3769 "schema": { 3770 "type": "string" 3771 } 3772 } 3773 }, 3774 "description": "The feature collections shared by this API.\n\nThe dataset is organized as one or more feature collections. This resource\nprovides information about and access to the collections.\n\nThe response contains the list of collections. For each collection, a link\nto the items in the collection (path `/collections/{collectionId}/items`,\nlink relation `items`) as well as key information about the collection.\nThis information includes:\n\n* A local identifier for the collection that is unique for the dataset;\n* A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);\n* An optional title and description for the collection;\n* An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data;\n* An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature')." 3775 }, 3776 "500": { 3777 "content": { 3778 "application/json": { 3779 "schema": { 3780 "$ref": "#/components/schemas/exception" 3781 } 3782 }, 3783 "text/html": { 3784 "schema": { 3785 "type": "string" 3786 } 3787 } 3788 }, 3789 "description": "A server error occurred." 3790 } 3791 }, 3792 "summary": "the feature collections in the dataset", 3793 "tags": [ 3794 "Capabilities" 3795 ] 3796 } 3797 }, 3798 "/collections/{collectionId}": { 3799 "get": { 3800 "operationId": "describeCollection", 3801 "parameters": [ 3802 { 3803 "description": "local identifier of a collection", 3804 "explode": false, 3805 "in": "path", 3806 "name": "collectionId", 3807 "required": true, 3808 "schema": { 3809 "type": "string" 3810 }, 3811 "style": "simple" 3812 } 3813 ], 3814 "responses": { 3815 "200": { 3816 "$ref": "#/components/responses/Collection", 3817 "content": { 3818 "application/json": { 3819 "example": { 3820 "description": "Buildings in the city of Bonn.", 3821 "extent": { 3822 "spatial": { 3823 "bbox": [ 3824 [ 3825 7.01, 3826 50.63, 3827 7.22, 3828 50.78 3829 ] 3830 ] 3831 }, 3832 "temporal": { 3833 "interval": [ 3834 [ 3835 "2010-02-15T12:34:56Z", 3836 null 3837 ] 3838 ] 3839 } 3840 }, 3841 "id": "buildings", 3842 "links": [ 3843 { 3844 "href": "http://data.example.org/collections/buildings/items", 3845 "rel": "items", 3846 "title": "Buildings", 3847 "type": "application/geo+json" 3848 }, 3849 { 3850 "href": "http://data.example.org/collections/buildings/items.html", 3851 "rel": "items", 3852 "title": "Buildings", 3853 "type": "text/html" 3854 }, 3855 { 3856 "href": "https://creativecommons.org/publicdomain/zero/1.0/", 3857 "rel": "license", 3858 "title": "CC0-1.0", 3859 "type": "text/html" 3860 }, 3861 { 3862 "href": "https://creativecommons.org/publicdomain/zero/1.0/rdf", 3863 "rel": "license", 3864 "title": "CC0-1.0", 3865 "type": "application/rdf+xml" 3866 } 3867 ], 3868 "title": "Buildings" 3869 }, 3870 "schema": { 3871 "$ref": "#/components/schemas/collection" 3872 } 3873 }, 3874 "text/html": { 3875 "schema": { 3876 "type": "string" 3877 } 3878 } 3879 }, 3880 "description": "Information about the feature collection with id `collectionId`.\n\nThe response contains a link to the items in the collection\n(path `/collections/{collectionId}/items`, link relation `items`)\nas well as key information about the collection. This information\nincludes:\n\n* A local identifier for the collection that is unique for the dataset;\n* A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);\n* An optional title and description for the collection;\n* An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data;\n* An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature')." 3881 }, 3882 "404": { 3883 "description": "The requested resource does not exist on the server. For example, a path parameter had an incorrect value." 3884 }, 3885 "500": { 3886 "content": { 3887 "application/json": { 3888 "schema": { 3889 "$ref": "#/components/schemas/exception" 3890 } 3891 }, 3892 "text/html": { 3893 "schema": { 3894 "type": "string" 3895 } 3896 } 3897 }, 3898 "description": "A server error occurred." 3899 } 3900 }, 3901 "summary": "describe the feature collection with id `collectionId`", 3902 "tags": [ 3903 "Capabilities" 3904 ] 3905 } 3906 }, 3907 "/collections/{collectionId}/coverage/tiles": { 3908 "get": { 3909 "operationId": ".collection.coverage.getTileSetsList", 3910 "parameters": [ 3911 { 3912 "$ref": "#/components/parameters/collectionId-coverage" 3913 }, 3914 { 3915 "$ref": "#/components/parameters/f-metadata" 3916 } 3917 ], 3918 "responses": { 3919 "200": { 3920 "$ref": "#/components/responses/TileSetsList" 3921 }, 3922 "404": { 3923 "$ref": "#/components/responses/NotFound" 3924 }, 3925 "406": { 3926 "$ref": "#/components/responses/NotAcceptable" 3927 }, 3928 "500": { 3929 "$ref": "#/components/responses/ServerError" 3930 } 3931 }, 3932 "summary": "Retrieve the list of available coverage tilesets for the specified collection.", 3933 "tags": [ 3934 "Coverage Tiles" 3935 ] 3936 } 3937 }, 3938 "/collections/{collectionId}/coverage/tiles/{tileMatrixSetId}": { 3939 "get": { 3940 "operationId": ".collection.coverage.getTileSet", 3941 "parameters": [ 3942 { 3943 "$ref": "#/components/parameters/collectionId-coverage" 3944 }, 3945 { 3946 "$ref": "#/components/parameters/collections-coverage" 3947 }, 3948 { 3949 "$ref": "#/components/parameters/tileMatrixSetId" 3950 }, 3951 { 3952 "$ref": "#/components/parameters/f-metadata" 3953 } 3954 ], 3955 "responses": { 3956 "200": { 3957 "$ref": "#/components/responses/TileSet" 3958 }, 3959 "404": { 3960 "$ref": "#/components/responses/NotFound" 3961 }, 3962 "406": { 3963 "$ref": "#/components/responses/NotAcceptable" 3964 }, 3965 "500": { 3966 "$ref": "#/components/responses/ServerError" 3967 } 3968 }, 3969 "summary": "Retrieve the coverage tileset metadata for the specified collection and tiling scheme (tile matrix set)", 3970 "tags": [ 3971 "Coverage Tiles" 3972 ] 3973 } 3974 }, 3975 "/collections/{collectionId}/coverage/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 3976 "get": { 3977 "operationId": ".collection.coverage.getTile", 3978 "parameters": [ 3979 { 3980 "$ref": "#/components/parameters/tileMatrix" 3981 }, 3982 { 3983 "$ref": "#/components/parameters/tileRow" 3984 }, 3985 { 3986 "$ref": "#/components/parameters/tileCol" 3987 }, 3988 { 3989 "$ref": "#/components/parameters/datetime" 3990 }, 3991 { 3992 "$ref": "#/components/parameters/collectionId-coverage" 3993 }, 3994 { 3995 "$ref": "#/components/parameters/collections-coverage" 3996 }, 3997 { 3998 "$ref": "#/components/parameters/subset" 3999 }, 4000 { 4001 "$ref": "#/components/parameters/crs" 4002 }, 4003 { 4004 "$ref": "#/components/parameters/subset-crs" 4005 }, 4006 { 4007 "$ref": "#/components/parameters/tileMatrixSetId" 4008 }, 4009 { 4010 "$ref": "#/components/parameters/f-coverageTile" 4011 } 4012 ], 4013 "responses": { 4014 "200": { 4015 "$ref": "#/components/responses/CoverageTile" 4016 }, 4017 "204": { 4018 "$ref": "#/components/responses/EmptyTile" 4019 }, 4020 "404": { 4021 "$ref": "#/components/responses/NotFound" 4022 }, 4023 "406": { 4024 "$ref": "#/components/responses/NotAcceptable" 4025 }, 4026 "500": { 4027 "$ref": "#/components/responses/ServerError" 4028 } 4029 }, 4030 "summary": "Retrieve coverage tiles", 4031 "tags": [ 4032 "Coverage Tiles" 4033 ] 4034 } 4035 }, 4036 "/collections/{collectionId}/items": { 4037 "get": { 4038 "description": "Fetch features of the feature collection with id `collectionId`.\n\nEvery feature in a dataset belongs to a collection. A dataset may\nconsist of multiple feature collections. A feature collection is often a\ncollection of features of a similar type, based on a common schema.\n\nUse content negotiation to request HTML or GeoJSON.", 4039 "operationId": "getFeatures", 4040 "parameters": [ 4041 { 4042 "description": "local identifier of a collection", 4043 "explode": false, 4044 "in": "path", 4045 "name": "collectionId", 4046 "required": true, 4047 "schema": { 4048 "type": "string" 4049 }, 4050 "style": "simple" 4051 }, 4052 { 4053 "description": "The optional limit parameter limits the number of items that are presented in the response document.\n\nOnly items are counted that are on the first level of the collection in the response document.\nNested objects contained within the explicitly requested items shall not be counted.\n\nMinimum = 1. Maximum = 10000. Default = 10.", 4054 "explode": false, 4055 "in": "query", 4056 "name": "limit", 4057 "required": false, 4058 "schema": { 4059 "default": 10, 4060 "maximum": 10000, 4061 "minimum": 1, 4062 "type": "integer" 4063 }, 4064 "style": "form" 4065 }, 4066 { 4067 "description": "Only features that have a geometry that intersects the bounding box are selected.\nThe bounding box is provided as four or six numbers, depending on whether the\ncoordinate reference system includes a vertical axis (height or depth):\n\n* Lower left corner, coordinate axis 1\n* Lower left corner, coordinate axis 2\n* Minimum value, coordinate axis 3 (optional)\n* Upper right corner, coordinate axis 1\n* Upper right corner, coordinate axis 2\n* Maximum value, coordinate axis 3 (optional)\n\nIf the value consists of four numbers, the coordinate reference system is\nWGS 84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84)\nunless a different coordinate reference system is specified in the parameter `bbox-crs`.\n\nIf the value consists of six numbers, the coordinate reference system is WGS 84\nlongitude/latitude/ellipsoidal height (http://www.opengis.net/def/crs/OGC/0/CRS84h)\nunless a different coordinate reference system is specified in the parameter `bbox-crs`.\n\nThe query parameter `bbox-crs` is specified in OGC API - Features - Part 2: Coordinate\nReference Systems by Reference.\n\nFor WGS 84 longitude/latitude the values are in most cases the sequence of\nminimum longitude, minimum latitude, maximum longitude and maximum latitude.\nHowever, in cases where the box spans the antimeridian the first value\n(west-most box edge) is larger than the third value (east-most box edge).\n\nIf the vertical axis is included, the third and the sixth number are\nthe bottom and the top of the 3-dimensional bounding box.\n\nIf a feature has multiple spatial geometry properties, it is the decision of the\nserver whether only a single spatial geometry property is used to determine\nthe extent or all relevant geometries.", 4068 "explode": false, 4069 "in": "query", 4070 "name": "bbox", 4071 "required": false, 4072 "schema": { 4073 "items": { 4074 "type": "number" 4075 }, 4076 "type": "array" 4077 }, 4078 "style": "form" 4079 }, 4080 { 4081 "description": "Either a date-time or an interval. Date and time expressions adhere to RFC 3339.\nIntervals may be bounded or half-bounded (double-dots at start or end).\n\nExamples:\n\n* A date-time: \"2018-02-12T23:20:50Z\"\n* A bounded interval: \"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z\"\n* Half-bounded intervals: \"2018-02-12T00:00:00Z/..\" or \"../2018-03-18T12:31:12Z\"\n\nOnly features that have a temporal property that intersects the value of\n`datetime` are selected.\n\nIf a feature has multiple temporal properties, it is the decision of the\nserver whether only a single temporal property is used to determine\nthe extent or all relevant temporal properties.", 4082 "explode": false, 4083 "in": "query", 4084 "name": "datetime", 4085 "required": false, 4086 "schema": { 4087 "type": "string" 4088 }, 4089 "style": "form" 4090 } 4091 ], 4092 "responses": { 4093 "200": { 4094 "content": { 4095 "application/geo+json": { 4096 "example": { 4097 "features": [ 4098 { 4099 "geometry": { 4100 "coordinates": [ 4101 "..." 4102 ], 4103 "type": "Polygon" 4104 }, 4105 "id": "123", 4106 "properties": { 4107 "floors": "2", 4108 "function": "residential", 4109 "lastUpdate": "2015-08-01T12:34:56Z" 4110 }, 4111 "type": "Feature" 4112 }, 4113 { 4114 "geometry": { 4115 "coordinates": [ 4116 "..." 4117 ], 4118 "type": "Polygon" 4119 }, 4120 "id": "132", 4121 "properties": { 4122 "floors": "10", 4123 "function": "public use", 4124 "lastUpdate": "2013-12-03T10:15:37Z" 4125 }, 4126 "type": "Feature" 4127 } 4128 ], 4129 "links": [ 4130 { 4131 "href": "http://data.example.com/collections/buildings/items.json", 4132 "rel": "self", 4133 "title": "this document", 4134 "type": "application/geo+json" 4135 }, 4136 { 4137 "href": "http://data.example.com/collections/buildings/items.html", 4138 "rel": "alternate", 4139 "title": "this document as HTML", 4140 "type": "text/html" 4141 }, 4142 { 4143 "href": "http://data.example.com/collections/buildings/items.json\u0026offset=10\u0026limit=2", 4144 "rel": "next", 4145 "title": "next page", 4146 "type": "application/geo+json" 4147 } 4148 ], 4149 "numberMatched": 123, 4150 "numberReturned": 2, 4151 "timeStamp": "2018-04-03T14:52:23Z", 4152 "type": "FeatureCollection" 4153 }, 4154 "schema": { 4155 "$ref": "#/components/schemas/featureCollectionGeoJSON" 4156 } 4157 }, 4158 "text/html": { 4159 "schema": { 4160 "type": "string" 4161 } 4162 } 4163 }, 4164 "description": "The response is a document consisting of features in the collection.\nThe features included in the response are determined by the server\nbased on the query parameters of the request. To support access to\nlarger collections without overloading the client, the API supports\npaged access with links to the next page, if more features are selected\nthat the page size.\n\nThe `bbox` and `datetime` parameter can be used to select only a\nsubset of the features in the collection (the features that are in the\nbounding box or time interval). The `bbox` parameter matches all features\nin the collection that are not associated with a location, too. The\n`datetime` parameter matches all features in the collection that are\nnot associated with a time stamp or interval, too.\n\nThe `limit` parameter may be used to control the subset of the\nselected features that should be returned in the response, the page size.\nEach page may include information about the number of selected and\nreturned features (`numberMatched` and `numberReturned`) as well as\nlinks to support paging (link relation `next`)." 4165 }, 4166 "400": { 4167 "content": { 4168 "application/json": { 4169 "schema": { 4170 "$ref": "#/components/schemas/exception" 4171 } 4172 }, 4173 "text/html": { 4174 "schema": { 4175 "type": "string" 4176 } 4177 } 4178 }, 4179 "description": "A query parameter has an invalid value." 4180 }, 4181 "404": { 4182 "description": "The requested resource does not exist on the server. For example, a path parameter had an incorrect value." 4183 }, 4184 "500": { 4185 "content": { 4186 "application/json": { 4187 "schema": { 4188 "$ref": "#/components/schemas/exception" 4189 } 4190 }, 4191 "text/html": { 4192 "schema": { 4193 "type": "string" 4194 } 4195 } 4196 }, 4197 "description": "A server error occurred." 4198 } 4199 }, 4200 "summary": "fetch features", 4201 "tags": [ 4202 "Data" 4203 ] 4204 } 4205 }, 4206 "/collections/{collectionId}/items/{featureId}": { 4207 "get": { 4208 "description": "Fetch the feature with id `featureId` in the feature collection\nwith id `collectionId`.\n\nUse content negotiation to request HTML or GeoJSON.", 4209 "operationId": "getFeature", 4210 "parameters": [ 4211 { 4212 "description": "local identifier of a collection", 4213 "explode": false, 4214 "in": "path", 4215 "name": "collectionId", 4216 "required": true, 4217 "schema": { 4218 "type": "string" 4219 }, 4220 "style": "simple" 4221 }, 4222 { 4223 "description": "local identifier of a feature", 4224 "explode": false, 4225 "in": "path", 4226 "name": "featureId", 4227 "required": true, 4228 "schema": { 4229 "type": "string" 4230 }, 4231 "style": "simple" 4232 } 4233 ], 4234 "responses": { 4235 "200": { 4236 "content": { 4237 "application/geo+json": { 4238 "example": { 4239 "geometry": { 4240 "coordinates": [ 4241 "..." 4242 ], 4243 "type": "Polygon" 4244 }, 4245 "id": "123", 4246 "links": [ 4247 { 4248 "href": "http://data.example.com/id/building/123", 4249 "rel": "canonical", 4250 "title": "canonical URI of the building" 4251 }, 4252 { 4253 "href": "http://data.example.com/collections/buildings/items/123.json", 4254 "rel": "self", 4255 "title": "this document", 4256 "type": "application/geo+json" 4257 }, 4258 { 4259 "href": "http://data.example.com/collections/buildings/items/123.html", 4260 "rel": "alternate", 4261 "title": "this document as HTML", 4262 "type": "text/html" 4263 }, 4264 { 4265 "href": "http://data.example.com/collections/buildings", 4266 "rel": "collection", 4267 "title": "the collection document", 4268 "type": "application/geo+json" 4269 } 4270 ], 4271 "properties": { 4272 "floors": "2", 4273 "function": "residential", 4274 "lastUpdate": "2015-08-01T12:34:56Z" 4275 }, 4276 "type": "Feature" 4277 }, 4278 "schema": { 4279 "$ref": "#/components/schemas/featureGeoJSON" 4280 } 4281 }, 4282 "text/html": { 4283 "schema": { 4284 "type": "string" 4285 } 4286 } 4287 }, 4288 "description": "fetch the feature with id `featureId` in the feature collection\nwith id `collectionId`" 4289 }, 4290 "404": { 4291 "description": "The requested resource does not exist on the server. For example, a path parameter had an incorrect value." 4292 }, 4293 "500": { 4294 "content": { 4295 "application/json": { 4296 "schema": { 4297 "$ref": "#/components/schemas/exception" 4298 } 4299 }, 4300 "text/html": { 4301 "schema": { 4302 "type": "string" 4303 } 4304 } 4305 }, 4306 "description": "A server error occurred." 4307 } 4308 }, 4309 "summary": "fetch a single feature", 4310 "tags": [ 4311 "Data" 4312 ] 4313 } 4314 }, 4315 "/collections/{collectionId}/map/tiles": { 4316 "get": { 4317 "operationId": ".collection.map.getTileSetsList", 4318 "parameters": [ 4319 { 4320 "$ref": "#/components/parameters/collectionId-all" 4321 }, 4322 { 4323 "$ref": "#/components/parameters/f-metadata" 4324 } 4325 ], 4326 "responses": { 4327 "200": { 4328 "$ref": "#/components/responses/TileSetsList" 4329 }, 4330 "404": { 4331 "$ref": "#/components/responses/NotFound" 4332 }, 4333 "406": { 4334 "$ref": "#/components/responses/NotAcceptable" 4335 }, 4336 "500": { 4337 "$ref": "#/components/responses/ServerError" 4338 } 4339 }, 4340 "summary": "Retrieve a list of all map tilesets for specified collection.", 4341 "tags": [ 4342 "Map Tiles" 4343 ] 4344 } 4345 }, 4346 "/collections/{collectionId}/map/tiles/{tileMatrixSetId}": { 4347 "get": { 4348 "operationId": ".collection.map.getTileSet", 4349 "parameters": [ 4350 { 4351 "$ref": "#/components/parameters/collectionId-all" 4352 }, 4353 { 4354 "$ref": "#/components/parameters/collections" 4355 }, 4356 { 4357 "$ref": "#/components/parameters/tileMatrixSetId" 4358 }, 4359 { 4360 "$ref": "#/components/parameters/f-metadata" 4361 } 4362 ], 4363 "responses": { 4364 "200": { 4365 "$ref": "#/components/responses/TileSet" 4366 }, 4367 "404": { 4368 "$ref": "#/components/responses/NotFound" 4369 }, 4370 "406": { 4371 "$ref": "#/components/responses/NotAcceptable" 4372 }, 4373 "500": { 4374 "$ref": "#/components/responses/ServerError" 4375 } 4376 }, 4377 "summary": "Retrieve a map tile set metadata for the specified collection and tiling scheme (tile matrix set)", 4378 "tags": [ 4379 "Map Tiles" 4380 ] 4381 } 4382 }, 4383 "/collections/{collectionId}/map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 4384 "get": { 4385 "operationId": ".collection.map.getTile", 4386 "parameters": [ 4387 { 4388 "$ref": "#/components/parameters/tileMatrix" 4389 }, 4390 { 4391 "$ref": "#/components/parameters/tileRow" 4392 }, 4393 { 4394 "$ref": "#/components/parameters/tileCol" 4395 }, 4396 { 4397 "$ref": "#/components/parameters/datetime" 4398 }, 4399 { 4400 "$ref": "#/components/parameters/collectionId-all" 4401 }, 4402 { 4403 "$ref": "#/components/parameters/collections" 4404 }, 4405 { 4406 "$ref": "#/components/parameters/subset" 4407 }, 4408 { 4409 "$ref": "#/components/parameters/crs" 4410 }, 4411 { 4412 "$ref": "#/components/parameters/subset-crs" 4413 }, 4414 { 4415 "$ref": "#/components/parameters/bgcolor" 4416 }, 4417 { 4418 "$ref": "#/components/parameters/transparent" 4419 }, 4420 { 4421 "$ref": "#/components/parameters/tileMatrixSetId" 4422 }, 4423 { 4424 "$ref": "#/components/parameters/f-mapTile" 4425 } 4426 ], 4427 "responses": { 4428 "200": { 4429 "$ref": "#/components/responses/MapTile" 4430 }, 4431 "204": { 4432 "$ref": "#/components/responses/EmptyTile" 4433 }, 4434 "404": { 4435 "$ref": "#/components/responses/NotFound" 4436 }, 4437 "406": { 4438 "$ref": "#/components/responses/NotAcceptable" 4439 }, 4440 "500": { 4441 "$ref": "#/components/responses/ServerError" 4442 } 4443 }, 4444 "summary": "Retrieve a map tile from the specified collection", 4445 "tags": [ 4446 "Map Tiles" 4447 ] 4448 } 4449 }, 4450 "/collections/{collectionId}/styles/{styleId}/map/tiles": { 4451 "get": { 4452 "operationId": ".collection.style.map.getTileSetsList", 4453 "parameters": [ 4454 { 4455 "$ref": "#/components/parameters/collectionId-all" 4456 }, 4457 { 4458 "$ref": "#/components/parameters/f-metadata" 4459 }, 4460 { 4461 "$ref": "#/components/parameters/styleId-collection" 4462 } 4463 ], 4464 "responses": { 4465 "200": { 4466 "$ref": "#/components/responses/TileSetsList" 4467 }, 4468 "404": { 4469 "$ref": "#/components/responses/NotFound" 4470 }, 4471 "406": { 4472 "$ref": "#/components/responses/NotAcceptable" 4473 }, 4474 "500": { 4475 "$ref": "#/components/responses/ServerError" 4476 } 4477 }, 4478 "summary": "Retrieve a list of styled map tilesets for the specified collection", 4479 "tags": [ 4480 "Map Tiles" 4481 ] 4482 } 4483 }, 4484 "/collections/{collectionId}/styles/{styleId}/map/tiles/{tileMatrixSetId}": { 4485 "get": { 4486 "operationId": ".collection.style.map.getTileSet", 4487 "parameters": [ 4488 { 4489 "$ref": "#/components/parameters/collectionId-all" 4490 }, 4491 { 4492 "$ref": "#/components/parameters/collections" 4493 }, 4494 { 4495 "$ref": "#/components/parameters/styleId-collection" 4496 }, 4497 { 4498 "$ref": "#/components/parameters/tileMatrixSetId" 4499 }, 4500 { 4501 "$ref": "#/components/parameters/f-metadata" 4502 } 4503 ], 4504 "responses": { 4505 "200": { 4506 "$ref": "#/components/responses/TileSet" 4507 }, 4508 "404": { 4509 "$ref": "#/components/responses/NotFound" 4510 }, 4511 "406": { 4512 "$ref": "#/components/responses/NotAcceptable" 4513 }, 4514 "500": { 4515 "$ref": "#/components/responses/ServerError" 4516 } 4517 }, 4518 "summary": "Retrieve the map tileset metadata for the specified collection, style and tiling scheme (tile matrix set).", 4519 "tags": [ 4520 "Map Tiles" 4521 ] 4522 } 4523 }, 4524 "/collections/{collectionId}/styles/{styleId}/map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 4525 "get": { 4526 "operationId": ".collection.style.map.getTile", 4527 "parameters": [ 4528 { 4529 "$ref": "#/components/parameters/tileMatrix" 4530 }, 4531 { 4532 "$ref": "#/components/parameters/tileRow" 4533 }, 4534 { 4535 "$ref": "#/components/parameters/tileCol" 4536 }, 4537 { 4538 "$ref": "#/components/parameters/datetime" 4539 }, 4540 { 4541 "$ref": "#/components/parameters/collectionId-all" 4542 }, 4543 { 4544 "$ref": "#/components/parameters/collections" 4545 }, 4546 { 4547 "$ref": "#/components/parameters/subset" 4548 }, 4549 { 4550 "$ref": "#/components/parameters/crs" 4551 }, 4552 { 4553 "$ref": "#/components/parameters/subset-crs" 4554 }, 4555 { 4556 "$ref": "#/components/parameters/bgcolor" 4557 }, 4558 { 4559 "$ref": "#/components/parameters/transparent" 4560 }, 4561 { 4562 "$ref": "#/components/parameters/styleId-collection" 4563 }, 4564 { 4565 "$ref": "#/components/parameters/tileMatrixSetId" 4566 }, 4567 { 4568 "$ref": "#/components/parameters/f-mapTile" 4569 } 4570 ], 4571 "responses": { 4572 "200": { 4573 "$ref": "#/components/responses/MapTile" 4574 }, 4575 "204": { 4576 "$ref": "#/components/responses/EmptyTile" 4577 }, 4578 "404": { 4579 "$ref": "#/components/responses/NotFound" 4580 }, 4581 "406": { 4582 "$ref": "#/components/responses/NotAcceptable" 4583 }, 4584 "500": { 4585 "$ref": "#/components/responses/ServerError" 4586 } 4587 }, 4588 "summary": "Retrieve a map tile for a specified collection and style", 4589 "tags": [ 4590 "Map Tiles" 4591 ] 4592 } 4593 }, 4594 "/collections/{collectionId}/styles/{styleId}/tiles": { 4595 "get": { 4596 "operationId": ".collection.style.vector.getTileSetsList", 4597 "parameters": [ 4598 { 4599 "$ref": "#/components/parameters/collectionId-vectorTiles" 4600 }, 4601 { 4602 "$ref": "#/components/parameters/f-metadata" 4603 }, 4604 { 4605 "$ref": "#/components/parameters/styleId-collection" 4606 } 4607 ], 4608 "responses": { 4609 "200": { 4610 "$ref": "#/components/responses/TileSetsList" 4611 }, 4612 "404": { 4613 "$ref": "#/components/responses/NotFound" 4614 }, 4615 "406": { 4616 "$ref": "#/components/responses/NotAcceptable" 4617 }, 4618 "500": { 4619 "$ref": "#/components/responses/ServerError" 4620 } 4621 }, 4622 "summary": "Retrieve a list of vector tilesets for the specified collection intended for use with a specified style", 4623 "tags": [ 4624 "Vector Tiles" 4625 ] 4626 } 4627 }, 4628 "/collections/{collectionId}/styles/{styleId}/tiles/{tileMatrixSetId}": { 4629 "get": { 4630 "operationId": ".collection.style.vector.getTileSet", 4631 "parameters": [ 4632 { 4633 "$ref": "#/components/parameters/collectionId-vectorTiles" 4634 }, 4635 { 4636 "$ref": "#/components/parameters/collections-vectorTiles" 4637 }, 4638 { 4639 "$ref": "#/components/parameters/styleId-collection" 4640 }, 4641 { 4642 "$ref": "#/components/parameters/tileMatrixSetId" 4643 }, 4644 { 4645 "$ref": "#/components/parameters/f-metadata" 4646 } 4647 ], 4648 "responses": { 4649 "200": { 4650 "$ref": "#/components/responses/TileSet" 4651 }, 4652 "404": { 4653 "$ref": "#/components/responses/NotFound" 4654 }, 4655 "406": { 4656 "$ref": "#/components/responses/NotAcceptable" 4657 }, 4658 "500": { 4659 "$ref": "#/components/responses/ServerError" 4660 } 4661 }, 4662 "summary": "Retrieve the vector tileset metadata for the specified collection, style and tiling scheme (tile matrix set).", 4663 "tags": [ 4664 "Vector Tiles" 4665 ] 4666 } 4667 }, 4668 "/collections/{collectionId}/styles/{styleId}/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 4669 "get": { 4670 "operationId": ".collection.style.vector.getTile", 4671 "parameters": [ 4672 { 4673 "$ref": "#/components/parameters/tileMatrix" 4674 }, 4675 { 4676 "$ref": "#/components/parameters/tileRow" 4677 }, 4678 { 4679 "$ref": "#/components/parameters/tileCol" 4680 }, 4681 { 4682 "$ref": "#/components/parameters/datetime" 4683 }, 4684 { 4685 "$ref": "#/components/parameters/collectionId-vectorTiles" 4686 }, 4687 { 4688 "$ref": "#/components/parameters/collections-vectorTiles" 4689 }, 4690 { 4691 "$ref": "#/components/parameters/subset" 4692 }, 4693 { 4694 "$ref": "#/components/parameters/crs" 4695 }, 4696 { 4697 "$ref": "#/components/parameters/subset-crs" 4698 }, 4699 { 4700 "$ref": "#/components/parameters/bgcolor" 4701 }, 4702 { 4703 "$ref": "#/components/parameters/transparent" 4704 }, 4705 { 4706 "$ref": "#/components/parameters/styleId-collection" 4707 }, 4708 { 4709 "$ref": "#/components/parameters/tileMatrixSetId" 4710 }, 4711 { 4712 "$ref": "#/components/parameters/f-vectorTile" 4713 } 4714 ], 4715 "responses": { 4716 "200": { 4717 "$ref": "#/components/responses/VectorTile" 4718 }, 4719 "204": { 4720 "$ref": "#/components/responses/EmptyTile" 4721 }, 4722 "404": { 4723 "$ref": "#/components/responses/NotFound" 4724 }, 4725 "406": { 4726 "$ref": "#/components/responses/NotAcceptable" 4727 }, 4728 "500": { 4729 "$ref": "#/components/responses/ServerError" 4730 } 4731 }, 4732 "summary": "Retrieve vector tiles for a specified collection, intended for use with a specified style", 4733 "tags": [ 4734 "Vector Tiles" 4735 ] 4736 } 4737 }, 4738 "/collections/{collectionId}/tiles": { 4739 "get": { 4740 "operationId": ".collection.vector.getTileSetsList", 4741 "parameters": [ 4742 { 4743 "$ref": "#/components/parameters/collectionId-vectorTiles" 4744 }, 4745 { 4746 "$ref": "#/components/parameters/f-metadata" 4747 } 4748 ], 4749 "responses": { 4750 "200": { 4751 "$ref": "#/components/responses/TileSetsList" 4752 }, 4753 "404": { 4754 "$ref": "#/components/responses/NotFound" 4755 }, 4756 "406": { 4757 "$ref": "#/components/responses/NotAcceptable" 4758 }, 4759 "500": { 4760 "$ref": "#/components/responses/ServerError" 4761 } 4762 }, 4763 "summary": "Retrieve a list of available vector tilesets for the specified collection.", 4764 "tags": [ 4765 "Vector Tiles" 4766 ] 4767 } 4768 }, 4769 "/collections/{collectionId}/tiles/{tileMatrixSetId}": { 4770 "get": { 4771 "operationId": ".collection.vector.getTileSet", 4772 "parameters": [ 4773 { 4774 "$ref": "#/components/parameters/collectionId-vectorTiles" 4775 }, 4776 { 4777 "$ref": "#/components/parameters/collections-vectorTiles" 4778 }, 4779 { 4780 "$ref": "#/components/parameters/tileMatrixSetId" 4781 }, 4782 { 4783 "$ref": "#/components/parameters/f-metadata" 4784 } 4785 ], 4786 "responses": { 4787 "200": { 4788 "$ref": "#/components/responses/TileSet" 4789 }, 4790 "404": { 4791 "$ref": "#/components/responses/NotFound" 4792 }, 4793 "406": { 4794 "$ref": "#/components/responses/NotAcceptable" 4795 }, 4796 "500": { 4797 "$ref": "#/components/responses/ServerError" 4798 } 4799 }, 4800 "summary": "Retrieve the vector tileset metadata for the specified collection and tiling scheme (tile matrix set)", 4801 "tags": [ 4802 "Vector Tiles" 4803 ] 4804 } 4805 }, 4806 "/collections/{collectionId}/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 4807 "get": { 4808 "operationId": ".collection.vector.getTile", 4809 "parameters": [ 4810 { 4811 "$ref": "#/components/parameters/tileMatrix" 4812 }, 4813 { 4814 "$ref": "#/components/parameters/tileRow" 4815 }, 4816 { 4817 "$ref": "#/components/parameters/tileCol" 4818 }, 4819 { 4820 "$ref": "#/components/parameters/datetime" 4821 }, 4822 { 4823 "$ref": "#/components/parameters/collectionId-vectorTiles" 4824 }, 4825 { 4826 "$ref": "#/components/parameters/collections-vectorTiles" 4827 }, 4828 { 4829 "$ref": "#/components/parameters/subset" 4830 }, 4831 { 4832 "$ref": "#/components/parameters/crs" 4833 }, 4834 { 4835 "$ref": "#/components/parameters/subset-crs" 4836 }, 4837 { 4838 "$ref": "#/components/parameters/tileMatrixSetId" 4839 }, 4840 { 4841 "$ref": "#/components/parameters/f-vectorTile" 4842 } 4843 ], 4844 "responses": { 4845 "200": { 4846 "$ref": "#/components/responses/VectorTile" 4847 }, 4848 "204": { 4849 "$ref": "#/components/responses/EmptyTile" 4850 }, 4851 "404": { 4852 "$ref": "#/components/responses/NotFound" 4853 }, 4854 "406": { 4855 "$ref": "#/components/responses/NotAcceptable" 4856 }, 4857 "500": { 4858 "$ref": "#/components/responses/ServerError" 4859 } 4860 }, 4861 "summary": "Retrieve a vector tile from a collection.", 4862 "tags": [ 4863 "Vector Tiles" 4864 ] 4865 } 4866 }, 4867 "/conformance": { 4868 "get": { 4869 "description": "A list of all conformance classes specified in a standard that the\nserver conforms to.", 4870 "operationId": "getConformanceDeclaration", 4871 "parameters": [ 4872 { 4873 "$ref": "#/components/parameters/f-metadata" 4874 } 4875 ], 4876 "responses": { 4877 "200": { 4878 "$ref": "#/components/responses/Conformance", 4879 "content": { 4880 "application/json": { 4881 "example": { 4882 "conformsTo": [ 4883 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core", 4884 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30", 4885 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/html", 4886 "http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson" 4887 ] 4888 }, 4889 "schema": { 4890 "$ref": "#/components/schemas/confClasses" 4891 } 4892 }, 4893 "text/html": { 4894 "schema": { 4895 "type": "string" 4896 } 4897 } 4898 }, 4899 "description": "The URIs of all conformance classes supported by the server.\n\nTo support \"generic\" clients that want to access multiple\nOGC API Features implementations - and not \"just\" a specific\nAPI / server, the server declares the conformance\nclasses it implements and conforms to." 4900 }, 4901 "406": { 4902 "$ref": "#/components/responses/NotAcceptable" 4903 }, 4904 "500": { 4905 "$ref": "#/components/responses/ServerError", 4906 "content": { 4907 "application/json": { 4908 "schema": { 4909 "$ref": "#/components/schemas/exception" 4910 } 4911 }, 4912 "text/html": { 4913 "schema": { 4914 "type": "string" 4915 } 4916 } 4917 }, 4918 "description": "A server error occurred." 4919 } 4920 }, 4921 "summary": "information about specifications that this API conforms to", 4922 "tags": [ 4923 "Capabilities" 4924 ] 4925 } 4926 }, 4927 "/map/tiles": { 4928 "get": { 4929 "operationId": ".dataset.map.getTileSetsList", 4930 "parameters": [ 4931 { 4932 "$ref": "#/components/parameters/f-metadata" 4933 } 4934 ], 4935 "responses": { 4936 "200": { 4937 "$ref": "#/components/responses/TileSetsList" 4938 }, 4939 "404": { 4940 "$ref": "#/components/responses/NotFound" 4941 }, 4942 "406": { 4943 "$ref": "#/components/responses/NotAcceptable" 4944 }, 4945 "500": { 4946 "$ref": "#/components/responses/ServerError" 4947 } 4948 }, 4949 "summary": "Retrieve the list of all default map tilesets for the whole dataset", 4950 "tags": [ 4951 "Map Tiles" 4952 ] 4953 } 4954 }, 4955 "/map/tiles/{tileMatrixSetId}": { 4956 "get": { 4957 "operationId": ".dataset.map.getTileSet", 4958 "parameters": [ 4959 { 4960 "$ref": "#/components/parameters/collections" 4961 }, 4962 { 4963 "$ref": "#/components/parameters/tileMatrixSetId" 4964 }, 4965 { 4966 "$ref": "#/components/parameters/f-metadata" 4967 } 4968 ], 4969 "responses": { 4970 "200": { 4971 "$ref": "#/components/responses/TileSet" 4972 }, 4973 "404": { 4974 "$ref": "#/components/responses/NotFound" 4975 }, 4976 "406": { 4977 "$ref": "#/components/responses/NotAcceptable" 4978 }, 4979 "500": { 4980 "$ref": "#/components/responses/ServerError" 4981 } 4982 }, 4983 "summary": "Retrieve a default map tileset of the whole dataset for the specified tiling scheme (tile matrix set)", 4984 "tags": [ 4985 "Map Tiles" 4986 ] 4987 } 4988 }, 4989 "/map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 4990 "get": { 4991 "operationId": ".dataset.map.getTile", 4992 "parameters": [ 4993 { 4994 "$ref": "#/components/parameters/tileMatrix" 4995 }, 4996 { 4997 "$ref": "#/components/parameters/tileRow" 4998 }, 4999 { 5000 "$ref": "#/components/parameters/tileCol" 5001 }, 5002 { 5003 "$ref": "#/components/parameters/datetime" 5004 }, 5005 { 5006 "$ref": "#/components/parameters/collections" 5007 }, 5008 { 5009 "$ref": "#/components/parameters/subset" 5010 }, 5011 { 5012 "$ref": "#/components/parameters/crs" 5013 }, 5014 { 5015 "$ref": "#/components/parameters/subset-crs" 5016 }, 5017 { 5018 "$ref": "#/components/parameters/bgcolor" 5019 }, 5020 { 5021 "$ref": "#/components/parameters/transparent" 5022 }, 5023 { 5024 "$ref": "#/components/parameters/tileMatrixSetId" 5025 }, 5026 { 5027 "$ref": "#/components/parameters/f-mapTile" 5028 } 5029 ], 5030 "responses": { 5031 "200": { 5032 "$ref": "#/components/responses/MapTile" 5033 }, 5034 "204": { 5035 "$ref": "#/components/responses/EmptyTile" 5036 }, 5037 "404": { 5038 "$ref": "#/components/responses/NotFound" 5039 }, 5040 "406": { 5041 "$ref": "#/components/responses/NotAcceptable" 5042 }, 5043 "500": { 5044 "$ref": "#/components/responses/ServerError" 5045 } 5046 }, 5047 "summary": "Retrieve a default map tile of the whole dataset", 5048 "tags": [ 5049 "Map Tiles" 5050 ] 5051 } 5052 }, 5053 "/styles/{styleId}/map/tiles": { 5054 "get": { 5055 "operationId": ".dataset.style.map.getTileSetsList", 5056 "parameters": [ 5057 { 5058 "$ref": "#/components/parameters/styleId" 5059 }, 5060 { 5061 "$ref": "#/components/parameters/f-metadata" 5062 } 5063 ], 5064 "responses": { 5065 "200": { 5066 "$ref": "#/components/responses/TileSetsList" 5067 }, 5068 "404": { 5069 "$ref": "#/components/responses/NotFound" 5070 }, 5071 "406": { 5072 "$ref": "#/components/responses/NotAcceptable" 5073 }, 5074 "500": { 5075 "$ref": "#/components/responses/ServerError" 5076 } 5077 }, 5078 "summary": "Retrieve the list of styled map tilesets for the whole dataset", 5079 "tags": [ 5080 "Map Tiles" 5081 ] 5082 } 5083 }, 5084 "/styles/{styleId}/map/tiles/{tileMatrixSetId}": { 5085 "get": { 5086 "operationId": ".dataset.style.map.getTileSet", 5087 "parameters": [ 5088 { 5089 "$ref": "#/components/parameters/styleId" 5090 }, 5091 { 5092 "$ref": "#/components/parameters/collections" 5093 }, 5094 { 5095 "$ref": "#/components/parameters/tileMatrixSetId" 5096 }, 5097 { 5098 "$ref": "#/components/parameters/f-metadata" 5099 } 5100 ], 5101 "responses": { 5102 "200": { 5103 "$ref": "#/components/responses/TileSet" 5104 }, 5105 "404": { 5106 "$ref": "#/components/responses/NotFound" 5107 }, 5108 "406": { 5109 "$ref": "#/components/responses/NotAcceptable" 5110 }, 5111 "500": { 5112 "$ref": "#/components/responses/ServerError" 5113 } 5114 }, 5115 "summary": "Retrieve a styled map tileset of the whole dataset for the specified tiling scheme (tile matrix set)", 5116 "tags": [ 5117 "Map Tiles" 5118 ] 5119 } 5120 }, 5121 "/styles/{styleId}/map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 5122 "get": { 5123 "operationId": ".dataset.style.map.getTile", 5124 "parameters": [ 5125 { 5126 "$ref": "#/components/parameters/tileMatrix" 5127 }, 5128 { 5129 "$ref": "#/components/parameters/tileRow" 5130 }, 5131 { 5132 "$ref": "#/components/parameters/tileCol" 5133 }, 5134 { 5135 "$ref": "#/components/parameters/datetime" 5136 }, 5137 { 5138 "$ref": "#/components/parameters/collections" 5139 }, 5140 { 5141 "$ref": "#/components/parameters/subset" 5142 }, 5143 { 5144 "$ref": "#/components/parameters/crs" 5145 }, 5146 { 5147 "$ref": "#/components/parameters/subset-crs" 5148 }, 5149 { 5150 "$ref": "#/components/parameters/bgcolor" 5151 }, 5152 { 5153 "$ref": "#/components/parameters/transparent" 5154 }, 5155 { 5156 "$ref": "#/components/parameters/styleId" 5157 }, 5158 { 5159 "$ref": "#/components/parameters/tileMatrixSetId" 5160 }, 5161 { 5162 "$ref": "#/components/parameters/f-mapTile" 5163 } 5164 ], 5165 "responses": { 5166 "200": { 5167 "$ref": "#/components/responses/MapTile" 5168 }, 5169 "204": { 5170 "$ref": "#/components/responses/EmptyTile" 5171 }, 5172 "404": { 5173 "$ref": "#/components/responses/NotFound" 5174 }, 5175 "406": { 5176 "$ref": "#/components/responses/NotAcceptable" 5177 }, 5178 "500": { 5179 "$ref": "#/components/responses/ServerError" 5180 } 5181 }, 5182 "summary": "Retrieve a styled map tiles", 5183 "tags": [ 5184 "Map Tiles" 5185 ] 5186 } 5187 }, 5188 "/styles/{styleId}/tiles": { 5189 "get": { 5190 "operationId": ".dataset.style.vector.getTileSetsList", 5191 "parameters": [ 5192 { 5193 "$ref": "#/components/parameters/styleId" 5194 }, 5195 { 5196 "$ref": "#/components/parameters/f-metadata" 5197 } 5198 ], 5199 "responses": { 5200 "200": { 5201 "$ref": "#/components/responses/TileSetsList" 5202 }, 5203 "404": { 5204 "$ref": "#/components/responses/NotFound" 5205 }, 5206 "406": { 5207 "$ref": "#/components/responses/NotAcceptable" 5208 }, 5209 "500": { 5210 "$ref": "#/components/responses/ServerError" 5211 } 5212 }, 5213 "summary": "Retrieve the list of vector tilesets intended for use with a specified style for the whole dataset", 5214 "tags": [ 5215 "Vector Tiles" 5216 ] 5217 } 5218 }, 5219 "/styles/{styleId}/tiles/{tileMatrixSetId}": { 5220 "get": { 5221 "operationId": ".dataset.style.vector.getTileSet", 5222 "parameters": [ 5223 { 5224 "$ref": "#/components/parameters/styleId" 5225 }, 5226 { 5227 "$ref": "#/components/parameters/collections" 5228 }, 5229 { 5230 "$ref": "#/components/parameters/tileMatrixSetId" 5231 }, 5232 { 5233 "$ref": "#/components/parameters/f-metadata" 5234 } 5235 ], 5236 "responses": { 5237 "200": { 5238 "$ref": "#/components/responses/TileSet" 5239 }, 5240 "404": { 5241 "$ref": "#/components/responses/NotFound" 5242 }, 5243 "406": { 5244 "$ref": "#/components/responses/NotAcceptable" 5245 }, 5246 "500": { 5247 "$ref": "#/components/responses/ServerError" 5248 } 5249 }, 5250 "summary": "Retrieve a vector tileset intended for use with a specified style of the whole dataset for the specified tiling scheme (tile matrix set)", 5251 "tags": [ 5252 "Vector Tiles" 5253 ] 5254 } 5255 }, 5256 "/styles/{styleId}/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 5257 "get": { 5258 "operationId": ".dataset.style.vector.getTile", 5259 "parameters": [ 5260 { 5261 "$ref": "#/components/parameters/tileMatrix" 5262 }, 5263 { 5264 "$ref": "#/components/parameters/tileRow" 5265 }, 5266 { 5267 "$ref": "#/components/parameters/tileCol" 5268 }, 5269 { 5270 "$ref": "#/components/parameters/datetime" 5271 }, 5272 { 5273 "$ref": "#/components/parameters/collections-vectorTiles" 5274 }, 5275 { 5276 "$ref": "#/components/parameters/subset" 5277 }, 5278 { 5279 "$ref": "#/components/parameters/crs" 5280 }, 5281 { 5282 "$ref": "#/components/parameters/subset-crs" 5283 }, 5284 { 5285 "$ref": "#/components/parameters/styleId" 5286 }, 5287 { 5288 "$ref": "#/components/parameters/tileMatrixSetId" 5289 }, 5290 { 5291 "$ref": "#/components/parameters/f-vectorTile" 5292 } 5293 ], 5294 "responses": { 5295 "200": { 5296 "$ref": "#/components/responses/VectorTile" 5297 }, 5298 "204": { 5299 "$ref": "#/components/responses/EmptyTile" 5300 }, 5301 "404": { 5302 "$ref": "#/components/responses/NotFound" 5303 }, 5304 "406": { 5305 "$ref": "#/components/responses/NotAcceptable" 5306 }, 5307 "500": { 5308 "$ref": "#/components/responses/ServerError" 5309 } 5310 }, 5311 "summary": "Retrieve vector tiles intended for use with a specified style", 5312 "tags": [ 5313 "Vector Tiles" 5314 ] 5315 } 5316 }, 5317 "/tileMatrixSets": { 5318 "get": { 5319 "operationId": "getTileMatrixSetsList", 5320 "parameters": [ 5321 { 5322 "$ref": "#/components/parameters/f-metadata" 5323 } 5324 ], 5325 "responses": { 5326 "200": { 5327 "$ref": "#/components/responses/TileMatrixSetsList" 5328 }, 5329 "406": { 5330 "$ref": "#/components/responses/NotAcceptable" 5331 }, 5332 "500": { 5333 "$ref": "#/components/responses/ServerError" 5334 } 5335 }, 5336 "summary": "Retrieve the list of available tiling schemes (tile matrix sets)", 5337 "tags": [ 5338 "Tiling Schemes" 5339 ] 5340 } 5341 }, 5342 "/tileMatrixSets/{tileMatrixSetId}": { 5343 "get": { 5344 "operationId": "getTileMatrixSet", 5345 "parameters": [ 5346 { 5347 "$ref": "#/components/parameters/tileMatrixSetId" 5348 }, 5349 { 5350 "$ref": "#/components/parameters/f-metadata" 5351 } 5352 ], 5353 "responses": { 5354 "200": { 5355 "$ref": "#/components/responses/TileMatrixSet" 5356 }, 5357 "404": { 5358 "content": { 5359 "application/json": { 5360 "schema": { 5361 "$ref": "#/components/schemas/exception" 5362 } 5363 } 5364 }, 5365 "description": "The requested tile matrix set id was not found" 5366 }, 5367 "406": { 5368 "$ref": "#/components/responses/NotAcceptable" 5369 }, 5370 "500": { 5371 "$ref": "#/components/responses/ServerError" 5372 } 5373 }, 5374 "summary": "Retrieve the definition of the specified tiling scheme (tile matrix set)", 5375 "tags": [ 5376 "Tiling Schemes" 5377 ] 5378 } 5379 }, 5380 "/tiles": { 5381 "get": { 5382 "operationId": ".dataset.vector.getTileSetsList", 5383 "parameters": [ 5384 { 5385 "$ref": "#/components/parameters/f-metadata" 5386 } 5387 ], 5388 "responses": { 5389 "200": { 5390 "$ref": "#/components/responses/TileSetsList" 5391 }, 5392 "404": { 5393 "$ref": "#/components/responses/NotFound" 5394 }, 5395 "406": { 5396 "$ref": "#/components/responses/NotAcceptable" 5397 }, 5398 "500": { 5399 "$ref": "#/components/responses/ServerError" 5400 } 5401 }, 5402 "summary": "Retrieve a list of available vector tilesets for the dataset", 5403 "tags": [ 5404 "Vector Tiles" 5405 ] 5406 } 5407 }, 5408 "/tiles/{tileMatrixSetId}": { 5409 "get": { 5410 "operationId": ".dataset.vector.getTileSet", 5411 "parameters": [ 5412 { 5413 "$ref": "#/components/parameters/collections" 5414 }, 5415 { 5416 "$ref": "#/components/parameters/tileMatrixSetId" 5417 }, 5418 { 5419 "$ref": "#/components/parameters/f-metadata" 5420 } 5421 ], 5422 "responses": { 5423 "200": { 5424 "$ref": "#/components/responses/TileSet" 5425 }, 5426 "404": { 5427 "$ref": "#/components/responses/NotFound" 5428 }, 5429 "406": { 5430 "$ref": "#/components/responses/NotAcceptable" 5431 }, 5432 "500": { 5433 "$ref": "#/components/responses/ServerError" 5434 } 5435 }, 5436 "summary": "Retrieve the vector tileset metadata for the whole dataset and the specified tiling scheme (tile matrix set)", 5437 "tags": [ 5438 "Vector Tiles" 5439 ] 5440 } 5441 }, 5442 "/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": { 5443 "get": { 5444 "operationId": ".dataset.vector.getTile", 5445 "parameters": [ 5446 { 5447 "$ref": "#/components/parameters/tileMatrix" 5448 }, 5449 { 5450 "$ref": "#/components/parameters/tileRow" 5451 }, 5452 { 5453 "$ref": "#/components/parameters/tileCol" 5454 }, 5455 { 5456 "$ref": "#/components/parameters/datetime" 5457 }, 5458 { 5459 "$ref": "#/components/parameters/collections-vectorTiles" 5460 }, 5461 { 5462 "$ref": "#/components/parameters/subset" 5463 }, 5464 { 5465 "$ref": "#/components/parameters/crs" 5466 }, 5467 { 5468 "$ref": "#/components/parameters/subset-crs" 5469 }, 5470 { 5471 "$ref": "#/components/parameters/tileMatrixSetId" 5472 }, 5473 { 5474 "$ref": "#/components/parameters/f-vectorTile" 5475 } 5476 ], 5477 "responses": { 5478 "200": { 5479 "$ref": "#/components/responses/VectorTile" 5480 }, 5481 "204": { 5482 "$ref": "#/components/responses/EmptyTile" 5483 }, 5484 "404": { 5485 "$ref": "#/components/responses/NotFound" 5486 }, 5487 "406": { 5488 "$ref": "#/components/responses/NotAcceptable" 5489 }, 5490 "500": { 5491 "$ref": "#/components/responses/ServerError" 5492 } 5493 }, 5494 "summary": "Retrieve a vector tile including one or more collections from the dataset.", 5495 "tags": [ 5496 "Vector Tiles" 5497 ] 5498 } 5499 } 5500 }, 5501 "servers": [ 5502 { 5503 "description": "Example OGC API server", 5504 "url": "https://www.example.org/ogcapi" 5505 } 5506 ], 5507 "tags": [ 5508 { 5509 "description": "essential characteristics of this API", 5510 "name": "Capabilities" 5511 }, 5512 { 5513 "description": "access to data (features)", 5514 "name": "Data" 5515 } 5516 ] 5517 }