Skip to content

overture

svcfmtm edited this page Oct 24, 2023 · 4 revisions

Overture Map Data

The Overture Foundation (https://www.overturemaps.org) has been recently formed to build a competitor to Google Maps. The plan is to use OpenStreetMap (OSM) data as a baselayer, and layer other datasets on top. The currently available data (July 2023) has 13 different datasets in addition to the OSM data. It is available here. It also includes a snapshot of OSM data from the same time frame. Other than the OSM data and MS Footprints, all the current additional data is US specific, and often contains multiple copies of the same dataset, but from different organization.

The Overture files are in Parquet format, which uses Arrow to store the data in a tabular fashion. The files are large, about 1.2G most of the time. Each file has features spread across the planet, instead of a subset in a geographical region. If you wish to get all the data for a region, you have to load all 120 files into a database.

While Overture recommends using Amazon Athena or Microsoft Synapse, you can also use a database.

Thee two primary databases are DuckDB, and Postgres, both of which have Parquet support. You can now also use ogr2ogr to import a parquet file into postgres. In these cases the database schema will resemble the Overture schema. Since HOT maintains it's own database schema that is also optimized for query performance, you can use the importer program to import into the Underpass schema. The importer utility can parse any of the data files that are using the V2 schema into GeoJson.

Schema

There are two versions of the file schema. The original schemawas had less columns in it, and each data type had a schema oriented towards that data type. The new schema (Oct 2023) is larger, but all the data types are supported in the same schema.

The schema used in the Overture data files is documented here. This document is just a summary with some implementation details.

Buildings

The current list of buildings datasets is:

  • Austin Building Footprints Year 2013 2D Buildings
  • Boston BPDA 3D Buildings
  • City of Cambridge, MA Open Data 3D Buildings
  • Denver Regional Council of Governments 2D Buildings
  • Esri Buildings | Austin Building Footprints Year 2013 2D Buildings
  • Esri Buildings | Denver Regional Council of Governments 2D Buildings
  • Esri Community Maps
  • Miami-Dade County Open Data 3D Buildings
  • OpenStreetMap
  • Microsoft ML Buildings
  • NYC Open Data 3D Buildings
  • Portland Building Footprint 2D Buildings
  • USGS Lidar
  • Washington DC Open Data 3D Buildings

Since the Microsoft ML Buildings and the OpenStreetMap data is available elsewhere, and is more up-to-date for global coverage, all of the other datasets are US only at this time.

The primary columns of interest to OSM are the number of building floors, the height in meters, and the name if it has one. These columns are not set in all of the datasets, but where they exist, they can be added to OSM during conflation.

As a warning, the USGS Lidar dataset has many really bad building geometries, so it's only the height column that is useful, if accurate.

Places

The places data are POIs of places. This appears to be for amenities, and contains tags related to that OSM category. This dataset is from Meta, and the data appears derived from Facebook.

The columns that are of interest to OSM are:

  • freeform - The address of the amenity, although the format is not consistent
  • socials - An array of social media links for this amenity.
  • phone - The phone number if it has one
  • websites - The website URL if it has one
  • value - The name of the amenity if known

Highways

In the current highway segment data files, the only source is OSM. In that cases it's better to use uptodate OSM data. It'll be interesting to see if Overture imports the publically available highway datasets from the USGS, or some state governments. That would be very useful.

The Overture segments data files are equivalent to an OSM way, with tags specific to that highway linestring. There are separate data files for connections, that are equivalant to an OSM relation.

Admin Boundaries

The administrative boundaries data is only OSM data, so there is no reason to care about these files.

Special Columns

names

The names column can have 4 variations on the name. Each may also have a language value as well.

  • common
  • official
  • alternate
  • short

Each of these can have multiple values, each of which consists of a value and the language.

sources

The sources column is an array of with two entries. The first entry is the name of the dataset, and where it exists, a recordID to reference the source dataset. For OSM data, the recordID has 3 sub-fields. The first character is the type, w (way), n (node), or l (line). The second is the OSM ID, and the third with a v is the version of the feature in OSM.

For example: *w***123456**v2 is a way with ID 123456 and is version 2.

Clone this wiki locally