OvertureMaps STAC 기반 데이터 추출하기

1️⃣ OvertureMaps의 STAC이란?

2026년 2월 11일, OvertureMaps 공식 페이지에 새로운 글이 추가되었다.

OvertureMaps가 STAC을 단순 릴리즈 산출물이 아니라, 운영 인프라의 핵심 구조로 채택했다는 발표다.

 

STAC에 대해서 간단하게 알아보면, SpatioTemporal Asset Catalogs의 약어이다.

즉, 공간(Spatial) + 시간(Temporal) 속성을 가진 데이터를 위한 메타데이터 카탈로그 규격이다.

 

Overture는 월 단위 릴리즈 구조를 가지기 때문에, 시간이 지남에 따라 데이터가 갱신되고 새로운 버전이 추가된다.

그렇기 때문에 데이터 배포일(release)을 지정하여 데이터를 직접 다운받는 방법이 존재하였으나, 최신 배포일에 따라서 항상 하드코딩된 코드를 변경해줘야 했다.

 

Overture DuckDB 예시

-- DuckDB 기반으로 데이터를 다운받는 경우 release/2026-01-21.0 데이터 버전을 기입
SELECT *
FROM read_parquet(
  's3://overturemaps-us-west-2/release/2026-01-21.0/theme=buildings/type=building/*.parquet'
)
LIMIT 10;

 

물론 릴리즈 버전만 변경해주면 상관이 없었으나, 매번 새로운 릴리즈 날짜를 확인하고 코드를 수정해주는건 번거로울 수 있다.

이런 번거로움을 해결하기 위해 STAC 기술이 등장하게 되었다.

글로 적는 것보다 직접 Overture STAC 릴리즈 정보를 확인해보도록 하자!

 

Overture STAC 루트 카탈로그

https://stac.overturemaps.org/catalog.json

해당 경로에 OvertureMaps data 최신 릴리즈 정보가 포함되어 있다. DuckDB에서 조회를 해보면

SELECT *
FROM 'https://stac.overturemaps.org/catalog.json';

좀 더 확인하기 쉽게 JSON 형태로 확인해보자

{
  "type": "Catalog",
  "id": "Overture Releases",
  "stac_version": "1.1.0",
  "description": "All Overture Releases",
  "links": [
    {
      "rel": "root",
      "href": "./catalog.json",
      "type": "application/json"
    },
    {
      "rel": "child",
      "href": "./2026-01-21.0/catalog.json",
      "type": "application/json",
      "title": "Latest Overture Release",
      "latest": true
    },
    {
      "rel": "child",
      "href": "./2025-12-17.0/catalog.json",
      "type": "application/json",
      "title": "2025-12-17.0 Overture Release"
    }
  ],
  "latest": "2026-01-21.0",

`type`, `id`, `stac_version`, `description`, `links`, `latest` 등 다양한 컬럼이 생성되었다. 

 

2️⃣ STAC에서 release 변수를 지정하여 최신 데이터 추출

그렇다면 이 STAC을 활용해서 최신 데이터를 코드 변경 없이 가져오는 방법에 대해서 알아보자

만약 내가 Overture 데이터를 추출하기 위해 S3 버킷 경로를 지정하고 최신 버전이 등장할 때 마다 하드코딩된 값을 변경했다면, 앞으로는 지정된 변수만 사용해주면 된다.

 

DuckDB에서 변수를 지정하고 최신 데이터 추출하기

SELECT latest FROM 'https://stac.overturemaps.org/catalog.json';

• STAC catalog에서 latest만 추출하면 현재 가장 최신 overture release 버전을 확인할 수 있다.
• 이 결과를 변수로 지정하고 클라우드 경로를 지정해주면 된다.

-- latest 값을 변수로 설정
SET VARIABLE latest = (
  SELECT latest 
  FROM 'https://stac.overturemaps.org/catalog.json');
 
-- parquet 파일이 저장된 경로에 latest 변수를 입력
SELECT id, geometry, theme, type
FROM read_parquet(
  's3://overturemaps-us-west-2/release/' 
  || getvariable('latest') 
  || '/theme=buildings/type=building/*.parquet'
)
LIMIT 10;

2026-01-21 최신 릴리즈 데이터 추출 가능

3️⃣ 테마별 최신 릴리즈 메타데이터 확인

테마별로 데이터 개수, 컬럼명 등 메타데이터를 확인하기 위해서는 다음과 같은 방법을 사용하면 된다.

 

Places 테마 메타데이터 예시

-- Places 테마 메타데이터 확인
SELECT *
FROM 'https://stac.overturemaps.org/2026-01-21.0/places/place/collection.json';