Skip to main content

Dataset

Dataset definition for Overture Maps data sources.

Fields

NameTypeDescription
source_namestringThe name of the source.
source_dataset_namestringThe name of the dataset being used from the source. This should match the 'dataset' value found in a record's sources column.
data_urlHttpUrlThe data page or data portal of this source, typically includes links to data downloads and license links.
data_url_archivedHttpUrlURL of the source's data page, stored on archive.org, at or near the date the source data was obtained for use within Overture.
license_urlHttpUrlA link to this source's data license or page referencing the license associated with the data being imported. This should include explicit license terms.
license_url_archivedHttpUrlURL of the source's license page, stored on archive.org, at or near the date the source data was obtained for use within Overture.
license_typestringThe license that is associated with the data being used from this source. This should be a valid SPDX license identifier when available.
license_textstringAny relevant license text, direct from the source's license page.
license_attributionstringAny attribution required by this source.
coverage_bboxlist<float64>The bounding box, in [xmin, ymin, xmax, ymax] format, of this source's coverage.

Minimum length: 4
Maximum length: 4
inception_datedate (optional)The first date this source was used in the Overture addresses theme, in YYYY-MM-DD format.
urlHttpUrl (optional)The home page of this source.
url_archivedHttpUrl (optional)URL of the source's home page, stored on archive.org, at or near the date the source data was obtained for use within Overture.
data_download_urllist<HttpUrl> (optional)Either a direct download link of data from this source, typically a geo-format or compressed file, or an endpoint from where the data was obtained for use within Overture.
countrieslist<CountryCodeAlpha2> (optional)A list of two-character iso country codes that this data source provides data in.
coverage_descriptionstring (optional)A description of the coverage type of the source data - i.e. national, regional, local.
data_layer_namestring (optional)Name of the data layer used from this source.
oa_pathlist<string> (optional)File path and name in OpenAddresses, if existing.
address_levelslist<string> (optional)Available address level attributes from OpenAddress, if existing.
file_formatstring (optional)Format of the file used from this source.
update_frequencystring (optional)How frequently the source data is updated upstream.
build_sourceBuildSource (optional)
update_typeUpdateType (optional)
update_schedulelist<string> (optional)The month or months in which the data is to be re-ingested by the Overture theme using this data source.
known_issuesstring (optional)A description of any issues with the data that are known - i.e. data is incomplete, coverage is incomplete, or issues with character encoding.
notesstring (optional)Freeform notes about this data source, including notes on any pre-processing requirements.
requires_attributionstring (optional)Whether this source requires attribution to be used in Overture Maps.

Used By