Authentication

curl "https://routes.placematic.com/v8/routes" \
  -H "x-api-key: $PLACEMATIC_KEY" \
  -G \
  --data-urlencode "transportMode=truck" \
  --data-urlencode "origin=42.0641,-88.0509" \
  --data-urlencode "destination=41.5250,-88.0817" \
  --data-urlencode "truck[height]=410" \
  --data-urlencode "return=summary"

import os
import requests

SESSION = requests.Session()
SESSION.headers.update({"x-api-key": os.environ["PLACEMATIC_KEY"]})

def route(origin: str, destination: str) -> dict:
    resp = SESSION.get(
        "https://routes.placematic.com/v8/routes",
        params={
            "transportMode": "truck",
            "origin": origin,
            "destination": destination,
            "truck[height]": 410,
            "return": "summary",
        },
        timeout=10,
    )
    if resp.status_code == 403:
        raise PermissionError("Key valid, entitlement missing — do not retry")
    if resp.status_code == 429:
        raise RuntimeError("Rate limited — back off, then retry")
    resp.raise_for_status()
    return resp.json()

const KEY = process.env.PLACEMATIC_KEY;

async function route(origin, destination) {
  const params = new URLSearchParams({
    transportMode: "truck",
    origin,
    destination,
    "truck[height]": "410",
    return: "summary",
  });

  const resp = await fetch(
    `https://routes.placematic.com/v8/routes?${params}`,
    { headers: { "x-api-key": KEY } }
  );

  if (resp.status === 403) {
    throw new Error("Entitlement missing — retrying will not help");
  }
  if (resp.status === 429) {
    throw new Error("Rate limited — apply exponential backoff");
  }
  if (!resp.ok) throw new Error(`HERE returned ${resp.status}`);

  return resp.json();
}