Skip to content

Agriculture 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: "agriculture",
  center: [-113.5, 52.1],
  zoom: 8,
});
live result
the code that produced it
import { Unmap } from "@unmap/sdk";

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

?profile=agriculture 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 agriculture add-on still gets the basemap. Overlay tiles are 403 addon_required. Founder and integration keys are exempt. profile does not change civic search routing. A ParcelMap BC PID (010-867-813) searches through legalLand, not agriculture, since the parcel fabric is cadastre: Agriculture reaches it through the bundle.

Catalog

Agriculture 0.1 overlays under the agriculture capability, plus ParcelMap BC under legalLand, which the Agriculture add-on also grants. Licence-complete AAFC / OGL-AB / OGL-BC archives only. Tile requests 404 until the objects land. This is not a national farm map.

idCoverageLicence
agriculture.cropsPrairie QS rollup of AAFC Annual Crop Inventory (AB / SK / BC Peace)OGL-Canada
agriculture.soilsAB / SK / BC SLC v3.2. Coarse. Not AGRASID detail.OGL-Canada
agriculture.capabilityAlberta LSRS onlyOGL-Canada / OGL-AB
agriculture.alrBritish Columbia ALR onlyOGL-BC
agriculture.bc-capabilityBritish Columbia capability, 2015 vintageOGL-BC
agriculture.soil-ordersNational. AAFC Soil Landscapes of Canada v3.2, ~1:1M soil order and great groupOGL-Canada

Attribution on AAFC layers: Contains information licensed under the Open Government Licence – Canada. ALR and BC capability: Contains information licensed under the Open Government Licence – British Columbia.

agriculture.soil-orders is the one layer here that reaches past Manitoba: polygons return at Halifax and Toronto as readily as on the Prairies. It is also the coarsest, at roughly 1:1,000,000, so it is regional soil context rather than a soil survey. Where detailed provincial polygons exist, agriculture.soils is the better answer and this is the fallback around it. Both ride the profile, so a client can draw the detailed layer where it exists and this one elsewhere.

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

Not in this slice

HeldWhy
SK Crown land / pasturesLicence UNVERIFIED
ABMI wetlandsLicence UNVERIFIED
Drought MonitorAAFC table, no TC PMTiles archive
AGRASID detailed soilTable, not a standalone tile archive
TC Productivity Score / ag_summaryTownship Canada-derived, not AAFC
Field-access / farm-entrance routingEntrances are not reliable OSM edges. use_highways is public-road preference only. See Routing API

Legal descriptions (NW-25-24-1-W5) search through the legalLand capability, and so does a nine-digit ParcelMap BC PID (010-867-813 or 010867813), which searches as layer: "parcel". The BC parcel fabric is not an agriculture layer: it is every registered parcel in the province, downtown condos included, so it is gated and documented as legal land. If you want farmland specifically, intersect it with agriculture.alr. PIN, plan number, and parcel-name search are not shipped.

What is still stubbed

  • Archives are copied and branded locally via pipeline/layers. They are not on R2 until make upload. Until then tile requests 404 and the basemap still renders.

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