Skip to main content

Introduction

Welcome! Overture provides free and open map data normalized to a common schema. Our six data "themes" — addresses, buildings, base, divisions, places, and transportation — contain more than 3.7 billion features and will continue to expand in size and scale. The data we use to build our datasets comes from many sources, including OpenStreetMap, Meta, Microsoft, Esri, OpenAddresses, and more.

In this documentation, you'll find instructions for accessing and handling Overture's large datasets, reference material to help you understand the Overture schema, comprehensive guides to working with the many themes and types of Overture data, and hands-on examples using data wrangling, analysis, and visualization tools you know and love. Want to see what our community has been building? Check out the community projects section of our documentation for inspiration.

Overture data​

We release our data monthly as cloud-native GeoParquet files, partitioned by theme and type. Each data theme contains one or more feature types, mapped in this way:

type_theme_map = {
    "address": "addresses",
    "building": "buildings",
    "building_part": "buildings",
    "division": "divisions",
    "division_area": "divisions",
    "division_boundary": "divisions",
    "place": "places",
    "segment": "transportation",
    "connector": "transportation",
    "infrastructure": "base",
    "land": "base",
    "land_cover": "base",
    "land_use": "base",
    "water": "base"
}

You'll find the GeoParquet column definitions for each feature type in our data guides.

Overture schema​

Although we release our data as GeoParquet, the Overture schema is defined by the JSON schema, and GeoJSON is used as the canonical geospatial format. GeoJSON provides us with a mental model and language to express data constructions in the schema. In our schema reference docs, we describe key schema concepts for each theme and definitions and examples for each feature type.

Vision​

The member companies of the Overture Maps Foundation are working collaboratively to build the datasets and schema. They share a common vision:

Address the core, enable the periphery​

The Overture schema doesn't solve every problem. It offers complete, out-of-the-box solutions for the most fundamental "core" use cases. At the same time, the schema's extensible structure enables a wide range of other use cases ("the periphery").

Invent across the gap​

The mapping community already has access to many excellent tools, standards and practices. The Overture schema reuses these existing solutions to maximize compatibility and focus on solving unaddressed pain points.

Backward-compatible is forward-compatible​

No design is future-proof, but good designs stay relevant by adding features without breaking what already works. The Overture schema can be enhanced in a backward-compatible way.

Always open​

The Overture schema and data formats aim for compatibility with free and open-source tools, avoiding dependency on proprietary technologies.

Contact us​

We want to hear from you. Ask questions, report bugs, provide feedback, and submit contributions via our public Overture GitHub repositories:

Last updated on