Communicating the location of proposed or executed contract delivery is important to many users of contracting data.
This extension introduces two properties at the items
level to describe location:
deliveryAddress
- a standardAddress
block which can be used to provide a postal address where services should be delivered.deliveryLocation
- a new block consisting of GeoJSON and Gazetteer entries to describe a wider range of locations to which the contract line item relates.
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').
Below is an example of a geolocated item in the tender
section:
{
"tender": {
"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:
{
"tender": {
"items": [
{
"id": "item1",
"deliveryLocation": {
"geometry": {
"type": "LineString",
"coordinates": [
[
102,
0
],
[
103,
1
],
[
104,
0
],
[
105,
1
]
]
},
"gazetteer": {
"scheme": "OSMW",
"identifiers": [
"27895985"
]
},
"description": "St Aldate's",
"uri": "http://www.geonames.org/2640729/oxford.html"
}
}
]
}
}
You can take the contents of the geometry object, excluding the geometry
keyword, and plug this into any GeoJSON tool to see the shape that is described.
Report issues for this extension in the ocds-extensions repository, putting the extension's name in the issue's title.
- Disallow
Location.geometry
andLocation.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
- Disallow
Location.geometry.coordinates
from having null in its array of coordinates - Disallow
Location.gazetteer.identifiers
from having null in its array of strings - Correct name of locationGazetteers.csv codelist (was locationGazeteers.csv)
- Allow
Location.geometry
andLocation.gazetteer
to be null - Add title and description to
Location.gazetteer
- Add description to
Item.deliveryLocation
,Item.deliveryAddress
- Add geometryType.csv codelist for
Location.geometry.type
- List codelists in extension.json
- Add tests and tidy code