Documentation

Communicating the location of proposed or executed contract delivery is important to many users of contracting data.

Cette extension ajoute deux propriétés au niveau items pour décrire la localisation :

  • deliveryAddress - une composante Address standard qui peut être utilisée pour fournir une adresse postale à laquelle les services devraient être livrés.
  • deliveryLocation - une nouvelle composante constituée de GeoJSON et d'entrées Gazetteer (index géographique) pour décrire un ensemble plus large de lieux auxquels l'élément du marché se rapporte.

The locationGazetteers.csv codelist's Category column indicates whether the gazetteer has identifiers for the whole world ('Universal') or only some subset ('National' or 'Sub-National').

Exemple

Voici ci-dessous un exemple d'élément géolocalisé :

{
  "items": [
    {
      "id": "item1",
      "description": "Ceremonial Trumpets for Oxford Town Hall",
      "classification": {
        "description": "Trumpets",
        "scheme": "CPV",
        "id": "37312100",
        "uri": "http://purl.org/cpv/2008/code-37312100"
      },
      "deliveryLocation": {
        "geometry": {
          "type": "Point",
          "coordinates": [51.751944, -1.257778]
        },
        "gazetteer": {
          "scheme": "GEONAMES",
          "identifiers": ["2640729"]
        },
        "description": "Central Oxford",
        "uri": "http://www.geonames.org/2640729/oxford.html"
      },
      "deliveryAddress": {
        "postalCode": "OX1 1BX",
        "countryName": "United Kingdom",
        "streetAddress": "Town Hall, St Aldate's",
        "region": "Oxfordshire",
        "locality": "Oxford"
      },
      "unit": {
        "name": "Items",
        "value": {
          "currency": "GBP",
          "amount": 10000
        }
      },
      "quantity": 10
    }
  ]
}
``

If the procurement related to the rebuilding of a road, then the item could also specify more complex geometries such as:

```json
{
"deliveryLocation": {
  "geometry": {
    "type": "LineString",
    "coordinates": [ [ -1.256503402048622, 51.747792026616821 ], [ -1.256477837243949, 51.747500168748303 ], [ -1.256466773131763, 51.747365723021403 ], [ -1.256471969911729, 51.747246699996332 ], [ -1.256481860557471, 51.747182243160943 ], [ -1.256497618535434, 51.747079648666102 ] ]
  },
  "gazetteer": {
    "scheme": "OSMW",
    "identifiers": ["27895985"]
  },
  "description": "St Aldate's",
  "uri": "http://www.geonames.org/2640729/oxford.html"
}
}

Vous pouvez prendre le contenu de l'objet de géométrie, enlever le mot-clé geometry et le donner à n'importe quel outil utilisant du GeoJSON pour visualiser la forme qui est décrite.

Problèmes

Signalez les problèmes concernant cette extension dans le répertoire ocds, en mettant le nom de l'extension dans le titre du signalement.

Journal des modifications

v1.1.4

  • Disallow Location.geometry and Location.gazetteer from being null (bug introduced in v1.1.3)
  • Correct the order of longitude and latitude in field descriptions to match the GeoJSON specification
  • Describe elevation or altitude values
  • Remove Sphinx directives from readme
  • Update extension.json for Extension Explorer

v1.1.3

  • Interdit au champ Location.geometry.coordinates d'avoir des valeurs null dans sa liste de coordonnées
  • Interdit au champ Location.gazetteer.identifiers d'avoir une valeur null dans sa liste de chaînes de caractère
  • Corrige le nom de la nomenclature locationGazetteers.csv (était locationGazeteers.csv)
  • Autorise les champs Location.geometry and Location.gazetteer à prendre la valeur null
  • Ajoute un titre et une description à Location.gazetteer
  • Ajoute une description à Item.deliveryLocation, Item.deliveryAddress
  • Ajoute la nomenclature geometryType.csv pour le champ Location.geometry.type
  • Liste les nomenclatures dans extension.json
  • Ajoute des tests et nettoie le code