Marie

Purpose

Spatial query engine. Named after Marie Tharp, the oceanographic cartographer who mapped the Mid-Atlantic Ridge. Marie uses Equator’s spatial data to fulfill queries from applications and platform services — proximity searches, coverage analysis, path clearance, and zone-based lookups.

Responsibilities

  • Proximity queries (“find the 3 nearest charging stations to robot X”)

  • Coverage analysis (“which floors haven’t been cleaned today?”)

  • Path clearance (“is the corridor between A and B obstacle-free?”)

  • Zone-based resource lookup (“which robots are currently in Zone C?”)

  • Spatial aggregation (“total area cleaned this shift”)

Key Query Types

Query

Input

Output

Nearest

Point + type + count

Ordered list of landmarks/devices

Within Zone

Zone ID

List of devices/landmarks in that zone

Coverage

Map ID + time range

Coverage heatmap / uncovered regions

Path Check

Start + end points

Clearance status + alternative routes

Geofence

Device ID

Current zone(s) and geofence status

API Surface

Operation

Description

GET /query/nearest?point=&type=&limit=

Find nearest entities

GET /query/within-zone/{zoneId}

List entities in a zone

GET /query/coverage?map=&from=&to=

Coverage analysis

GET /query/path-check?from=&to=

Path clearance check

GET /query/geofence/{deviceId}

Device geofence status

Dependencies

Service

Relationship

Equator

Source of all spatial data (maps, zones, landmarks)

ThingIO

Real-time device positions for location-aware queries

DotID

Authentication and tenant scoping

Consumed By

Consumer

Usage

Planner

Route optimization, resource proximity

Scheduler

Zone-based resource allocation

Execution Manager

Path clearance before contract execution

Policy Service

Zone-based policy evaluation

WES

Proximity queries, path clearance, zone-based lookup

ClearJanitor

Coverage queries (“which floors haven’t been cleaned?”)