Skip to Content
ReferenceWorker Jobs

Worker jobs

Use this page with Global Geobase context and Worker API (base URL + auth).

Job quick reference

JobPurposeGuide
osmImportAreaOpenStreetMap extract → project tablesOpenStreetMap import
overtureImportAreaOverture Maps layers → {prefix}_{suffix} tablesOverture import
ogr2ogrImportFile URL → Postgres via ogr2ogrWorker OpenAPI /doc
createGeoEmbeddingsGeoTIFF → geoembeddings.*RPC API (query after) · GeoParquet
createSraiEmbeddingsSRAI OSM + H3 → geoembeddings.*Automated SRAI pipeline
archiveToPmtilesPostGIS table → Storage pmtiles/{table}.pmtilesArchive to PMTiles

Cancel: DELETE {WORKER_BASE_URL}/jobs/{taskName}/{job_id} (Studio: DELETE /api/projects/{ref}/jobs/{taskName}/{job_id}).

createGeoEmbeddings

FieldRequiredNotes
geotiffPathyesHTTPS (or worker-reachable) GeoTIFF / COG path
tableNameyesPostgreSQL identifier → geoembeddings.{tableName}
normalizeEmbeddingsnodefault true
tileSizenodefault 256
modelNamenodefault dinov3-vitl16-pretrain-sat493m
bandsnoband indices
uploadArtifactsToStoragenodefault false; GeoParquet (+ metadata) to Storage
projectTargetshared poolinclude projectRef (and DB/service credentials as required by the pool)

Fleet size guards (fail before ONNX): GEOEMBEDDINGS_MAX_TILES (default 10000), GEOEMBEDDINGS_MAX_GEOTIFF_BYTES (default 100 MiB); 0 disables.

curl -sS -X POST "${WORKER_BASE_URL}/jobs/createGeoEmbeddings" \
  -H "apikey: ${GEOBASE_SERVICE_ROLE_KEY}" \
  -H "Authorization: Bearer ${GEOBASE_SERVICE_ROLE_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "geotiffPath": "https://example.com/scene.tif",
    "tableName": "my_embeddings",
    "tileSize": 256,
    "uploadArtifactsToStorage": true
  }'

After success, query with RPC API or download artifacts via Connect to GeoParquet.

createSraiEmbeddings

See Automated SRAI pipeline for tableName, h3Resolution, placeQuery / aoiGeoJson, tags/presets, and Studio UI.

Imports and archive

  • OSM / Overture: require AOI fields (areaName, aoiGeoJson, plus topics or types for Overture) — see import guides.
  • archiveToPmtiles: body { "table": "…" } (optional schema, zooms); Storage bucket pmtiles must exist.

Human checkpoint

Poll job status until success / failed before wiring UI; validate payloads against {WORKER_BASE_URL}/doc.

Last updated on
Worker APIRouting Engine