DOCSEARCHbyAlgolia
Submit Docs

Overture Maps Documentation

website·Indexed 38 days ago

https://docs.overturemaps.org/

Documentation for Overture Maps, providing guides on accessing and querying global map data. Includes instructions for using the Overture Python client, Overture Maps Explorer, and integrations with BigQuery, Databricks, Snowflake, DuckDB, and Wherobots. Covers detailed schema references and theme guides for Addresses, Base (land, water, infrastructure), Buildings, Divisions, Places, and Transportation.

Tokens
84K
Snippets
303
Records
687
Agent score
70%

What's inside Overture Maps

  1. Overview of the Global Entity Reference System (GERS)

    The Global Entity Reference System (GERS) is a universal framework designed to structure and match map data across different systems. It provides stable identifiers (GERS IDs) for real-world geospatial entities—such as buildings, road segments, places, and addresses—ensuring consistency across Overture data releases and across multiple source datasets. GERS acts as a mechanism to simplify the integration and exchange of geospatial data layers.

  2. Overview of Overture Transportation dataset

    The Overture transportation theme is a global, open dataset of traversable segments (roads, railways, ferries) and connectors (intersections). It is built from OpenStreetMap (OSM) and enhanced with data from TomTom and other authoritative sources. It is designed for mapping, routing, navigation, and geocoding street intersections, supporting complex attributes like time-of-day speed limits and vehicle-specific access restrictions.

  3. Overview of Overture Maps Schema

    The Overture Maps schema defines the structure, properties, and constraints for geospatial features. It is organized into six primary themes and shared modules. The schema is authored using Pydantic models to ensure explicit types, clear validation rules, and semantic meaning for both humans and machines.

  4. Overview of Overture base infrastructure features

    The infrastructure feature type in the Overture base theme contains built-environment features derived from OpenStreetMap, including bridges, airports, communication towers, power lines, piers, barriers, and transit features. These features support Point, LineString, Polygon, or MultiPolygon geometries and are categorized using subtype and class attributes derived from OSM tags.

  5. Overview of Overture Base theme feature types

    The Overture Base theme provides global coverage of natural and man-made features. It consists of six primary feature types:

    • Bathymetry: Topographic representations of underwater areas (lake beds, ocean floors). Data is delivered as stacked depth levels where a feature with depth = d covers all water deeper than d meters.
    • Infrastructure: Real-world entities including bridges, airports, runways, aerialways, communication towers, and power lines.
    • Land: Physical land surfaces, including global land derived from the inverse of OSM Coastlines.
    • Land cover: The physical surface material (e.g., forests, crops, cities, wetlands), derived from ESA WorldCover.
    • Land use: The predominant human use of the land (e.g., commercial, recreation, farming, housing), translated from OSM landuse tags.
    • Water: Ocean and inland water bodies, categorized into ocean and inland marine surfaces.

  6. Overview of Overture Addresses theme

    The Overture Addresses theme (currently in Alpha) provides over 472 million address point entities. Each entity represents a physical place using attributes such as street number, street name, unit, address levels, postal code, and country, paired with a point geometry indicating the approximate location. It is designed for use cases including mapping, geocoding, conflation with other themes (like buildings), address standardization, normalization, and verification.

  7. Overview of the Overture Places theme

    The Overture places theme provides point representations of real-world entities such as businesses, landmarks, schools, hospitals, and religious organizations. It is published under CDLA Permissive 2.0 and Apache 2.0 licenses and contains no OpenStreetMap data, meaning it carries no ODbL share-alike obligations.

    Overture defines a 'place' as a concrete, physically identifiable, stationary destination in a publicly observable space. This definition specifically excludes:

    • Abstract entities (administrative areas, standalone address points)
    • Movable objects (food carts, vehicles, boats)
    • Intermediate waypoints (bus stops, train platforms)
    • Non-public spaces (private residences)
    • Data containing personally identifiable information (PII)

  9. Use NameRule for advanced feature naming

    The NameRule entity is used when a primary or common name is insufficient for a feature. It allows for the definition of names based on specific conditions, such as:

    • Official, alternate, or short names.
    • Geometric range scoping (names applying only to a specific segment of a linear path).
    • Side scoping (names applying only to the left or right side of a linear path).
    • Political perspectives (names accepted or disputed by specific countries).

  10. Model detailed 3D building components with BuildingPart

    The BuildingPart feature allows buildings to be modeled in rich detail for realistic 3D representations. Every BuildingPart must be associated with a parent Building feature via the building_id field. Building parts can be stacked or float; use min_height, min_floor, height, and num_floors to arrange them vertically.

  11. Infrastructure(Base) feature schema

    Infrastructure features provide basic information about real-world infrastructure entities such as bridges, airports, runways, aerialways, communication towers, and power lines. All features in this theme have theme: "base" and type: "infrastructure".
    {
  "theme": "base",
  "type": "infrastructure"
}