Documentation

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

Questa estensione introduce due proprietà al livello items per descrivere la posizione:

  • deliveryAddress - è una sezione del blocco Address che può essere utilizzato per fornire un indirizzo postale in cui i beni o servizi devono essere consegnati.
  • deliveryLocation: è un nuovo blocco costituito da voci in formato GeoJSON e Gazetteer per descrivere una gamma più ampia di geo-localizzazioni a cui si riferisce l'elemento pubblicitario del contratto.

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').

Esempio

Di seguito è riportato un esempio di oggetto geolocalizzato:

{
  "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"
}
}

Puoi prendere il contenuto dell'oggetto geometry, escludendo la parola chiave geometry, e utilizzarla in qualsiasi applicazione per visualizzare GeoJSON per vederne la forma.

Problemi (issues)

Segnala i problemi per questa estensione nel repository ocds-extensions, inserendo il nome dell'estensione nel titolo del problema.

Storico delle modifiche

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

  • Non consentire valori nulli nell'array del campo Location.geometry.coordinates
  • Non consentire valori nulli nell'array di stringhe del campo Location.gazetteer.identifiers
  • Il nome corretto del vocabolario controllato è locationGazetteers.csv (era locationGazeteers.csv)
  • Consenti valori nulli sui campi Location.geometry eLocation.gazetteer
  • Aggiungi titolo e descrizione a "Location.gazetteer"
  • Aggiungere la descrizione a Item.deliveryLocation,Item.deliveryAddress
  • Aggiungi elementi dal vocabolario geometryType.csv per Location.geometry.type
  • Elenca i valori ammissibili del vocabolari controllati in extension.json
  • Aggiungi test e codice ordinato