Energy profile

profile is a composition preset. It is not a thirteenth style, a third mode, or a theme. It names default overlays and hides buildings so customer data stays visually dominant.

import { Unmap } from "@unmap/sdk";
 
const unmap = new Unmap({
  key: "um_live_...",
  container: "map",
  style: "muted",
  profile: "energy",
  center: [-114.0719, 51.0447],
  zoom: 8,
});

style

mode

labels

live result

the code that produced it

import { Unmap } from "@unmap/sdk";

const unmap = new Unmap({
  key: "um_live_...",
  container: "map",
  style: "muted",
  profile: "energy",
  center: [-114.0719, 51.0447],
  zoom: 8,
});

?profile=energy on /styles/{style}.json expands to the same overlay set. Prefer muted. Unknown profile values are a 400. When both profile and overlays= are set, explicit overlays win: the profile list is replaced, not merged.

A key without the energy add-on still gets the basemap. Overlay tiles are 403 addon_required. Founder and integration keys are exempt.

Catalog

Energy 0.1 ids, all under the energy add-on. Archives are not uploaded. Tile requests 404 until the objects land. Petrinex activity/production and Manitoba Petroleum Branch are held and are not catalogued.

id	Coverage	Licence
`energy.wells`	Alberta (AER ST37). SK/BC unverified. MB held.	AER open data
`energy.pipelines`	Alberta (AER ST76). SK/BC unverified. No MB.	AER open data
`energy.facilities`	Alberta (AER ST102). SK/BC unverified. No MB.	AER open data
`energy.fields`	Unverified amalgam. MB held.	UNVERIFIED
`energy.petroleum-tenure`	Alberta (OGL-AB). Not national.	OGL-AB; SK/BC unverified
`energy.mineral-tenure`	Alberta (OGL-AB). Not national.	OGL-AB; SK/BC unverified
`energy.ccs`	Alberta only	AER / OGL-AB product UNVERIFIED
`energy.geothermal`	Alberta only	OGL-AB expected; product UNVERIFIED

Attribution on AER layers: Source: AER · ST37, ST76, ST101, ST102 · refreshed monthly. Crown tenure: Source: Alberta Energy · AMI Crown tenure · refreshed weekly.

GET /layers is the machine-readable source. Incomplete coverage is never hidden.

Search and identify (Energy 0.2)

UWI search is the energy add-on. An account key without it gets 403 addon_required. Founder and integration keys are exempt. Civic addresses never become wells.

Results are empty until the tables load. A UWI miss does not fall through to civic ranking and does not invent a coordinate.

await unmap.geocoder.search("00/01-01-001-01W4/0")

	Coverage
Intended	Alberta (AER ST37 wells, ST102 facilities)
SK / BC	UNVERIFIED for unmap redistribution
Manitoba	Held (Petroleum Branch)
Petrinex production	Held

Prefixed well licences (W0485123, LIC 123456) take the same gate. Bare digits do not. Facility names are too generic: pass layers=facility (or profile=energy / source=energy).

/identify?layers=energy.wells,energy.pipelines,energy.facilities (and fields / tenure) is empty-safe ST_Contains. Missing table → no features, not a 500. energy.ccs and energy.geothermal are not identify-capable (400). Default identify layers stay municipalities only.

profile: "energy" does not change /route. Resource, lease, and winter roads are not in the Canada graph. use_highways is public-road motorway preference only. See Routing API.

What is still stubbed

Tiles are stubs. The style composes overlay sources; MapLibre 404s the missing archives and the basemap still renders.

Registry

From registry.unmap.dev, both React and Vue lanes:

Item	Role
`energy-map`	`<Map>` / `<UnmapMap>` already composed with `profile="energy"` (muted by default). Map composition only, not a style.
`energy-layer-control`	Toggles the energy overlay set on a map that already used `profile="energy"`.
`well-search`	Search box labelled for UWIs. Sends the query string only; the gateway detects UWI vs civic. Do not pass `profile=` as a search source.
`energy-popup`	Identify wells, pipelines, and facilities on click.

legal-land-search is the LSD twin of well-search (same rule: query string only). See Geocoding.

See Layers for the catalog contract and Energy map for a live example.