Build on it, don't just buy into it

// npm install maplibre-arcgis maplibre-gl
import maplibregl from 'maplibre-gl';
import { ArcGISAuthManager, ArcGISLoginControl, EsriFeatureServiceControl } from 'maplibre-arcgis';
import 'maplibre-arcgis/style.css';

const map = new maplibregl.Map({
  container: 'map',
  style: 'https://basemaps.cartocdn.com/gl/positron-gl-style/style.json',
  center: [-98.5, 39.8],
  zoom: 4,
});

const auth = new ArcGISAuthManager({
  portalUrl: 'https://www.arcgis.com',
  authMethod: 'oauth2',
  clientId: 'YOUR_CLIENT_ID',
});

map.addControl(new ArcGISLoginControl({ auth }), 'top-right');

map.on('load', () => {
  map.addControl(new EsriFeatureServiceControl({
    id: 'parcels',
    url: 'https://services.arcgis.com/.../FeatureServer/0',
    auth,
  }));
});

import { ArcGISAuthManager } from 'maplibre-arcgis';

// OAuth2 / PKCE — recommended for user-facing apps
new ArcGISAuthManager({ portalUrl: 'https://www.arcgis.com', authMethod: 'oauth2', clientId: 'ID' });

// Static API key — ArcGIS Location Platform / developer accounts
new ArcGISAuthManager({ portalUrl: 'https://www.arcgis.com', authMethod: 'apikey', apiKey: 'KEY' });

// generateToken — ArcGIS Server / Enterprise
new ArcGISAuthManager({ portalUrl: 'https://my.portal.com', authMethod: 'token',
                        username: 'user', password: 'pass' });

// App credentials — server to server
new ArcGISAuthManager({ portalUrl: 'https://www.arcgis.com', authMethod: 'app',
                        clientId: 'ID', clientSecret: 'SECRET' });

// One manager, passed to every control that needs a token.

version: 1
title: Industrial Site Selector

auth:
  portal_url: https://my.portal.com
  method: oauth2
  client_id: abc123

view:
  center: [-98.5795, 39.8283]
  zoom: 6

controls:
  login: true
  duckdb_loader: true
  style_admin: true

layers:
  - { id: zoning,  type: feature_service, url: https://…/FeatureServer/0, opacity: 0.7 }
  - { id: dem,     type: cog_s3,          url: s3://my-bucket/dem.tif, colormap: terrain }
  - { id: lidar,   type: copc_lidar,      url: https://…/cloud.copc.laz }
  - { id: parcels, type: duckdb,          url: https://…/parcels.fgb, render_type: fill }

# maplibre-arcgis validate map.yaml
# maplibre-arcgis build    map.yaml   → portable static page
# maplibre-arcgis serve    map.yaml   → with COOP/COEP headers set

import { FeatureServiceEditor, geoJsonFeatureToEsri } from 'maplibre-arcgis';

const editor = new FeatureServiceEditor({
  url: 'https://services.arcgis.com/.../FeatureServer/0',
  auth,
});

const features = await editor.queryFeatures({ where: "ZoningCode = 'M1'" });

await editor.applyEdits({
  adds:    [geoJsonFeatureToEsri(newParcel, spatialReference)],
  updates: [updatedFeature],
  deletes: [staleFeature],
});

// Or give end users the editing panel directly:
// map.addControl(new FeatureEditorControl({ url, auth }), 'top-right');

# Esri FeatureServer contract
GET /parcels/FeatureServer                        # service descriptor
GET /parcels/FeatureServer/0                      # layer descriptor
GET /parcels/FeatureServer/0/query                # Esri /query contract

# OGC API Features contract
GET /parcels/ogc/collections/parcels              # collection metadata
GET /parcels/ogc/collections/parcels/items        # ?bbox=… &limit=…

# Unified cross-jurisdiction search
GET /parcels/search?parcel_id=010-001234&state=OH
GET /parcels/search?address=1+main+st+columbus+oh
GET /parcels/search?owner=acme+holdings&state=TX

# Registry admin — not exposed to mapping clients
GET  /admin/registry
GET  /admin/health
POST /admin/reload

# 1. Describe the jurisdiction. Keys are canonical names,
#    values are whatever the county happened to call them.
sources:
  parcels:
    url: https://services.arcgis.com/…/FeatureServer/0
    layer_name: austin_parcels
    srid: 2277
    attribution: "Travis Central Appraisal District"
    field_map:
      parcel_id: PROP_ID
      lot_size:  SQ_FT
      owner:     OWNER_NAME

output:
  dir: data/austin_tx
  queries:
    - { query: underbuilt_parcels,      file: 15_underbuilt.geojson }
    - { query: assemblage_candidates,   file: 16_assemblage.geojson }
    - { query: composite_opportunity_score, file: 17_composite.geojson }

# 2. Run it — whole, or one stage at a time.
python -m opportunity_pipeline.run jurisdictions/austin_tx.yaml
python -m opportunity_pipeline.run jurisdictions/austin_tx.yaml \
       --stages extract,convert
python -m opportunity_pipeline.run jurisdictions/austin_tx.yaml \
       --stages analyze -v

# 3. Read the manifest from your own client.
curl '…/data/austin_tx/manifest.json'       # layers + styles
curl '…/data/austin_tx/opportunities/15_underbuilt.geojson'