Aller au contenu

Apportez vos propres données

Les superpositions privées vivent sous le préfixe de votre compte sur R2. Elles participent à la carte comme une couche client au-dessus des catalogues canadien et sectoriels. Ce n'est pas un hébergement SIG générique : il n'y a ni recherche, ni identification, ni indexation sur les fichiers que vous nous envoyez.

Limites

PlafondValeur
Superpositions par compte10
Taille par superposition5 Mo
FormatsGeoJSON (FeatureCollection, Feature ou une géométrie) et PMTiles
AuthClé API sur /byod, cookie de session sur /account/byod

Un fichier trop grand ou une 11e superposition est 400 bad_request. Les clés sans accountId (fondateur / intégration) sont isolées par clé. Le paiement n'est pas branché pour un complément BYOD; 0.1 est authentifié par clé et plafonné.

Téléverser, lister, supprimer

curl -X POST "https://api.unmap.dev/byod?name=leases" \
  -H "Authorization: Bearer $UNMAP_API_KEY" \
  -H "Content-Type: application/geo+json" \
  --data-binary @leases.geojson
{
  "id": "ovl_aabbccddeeff",
  "name": "leases",
  "kind": "geojson",
  "bytes": 1284,
  "createdAt": "2026-09-11T18:00:00.000Z",
  "url": "https://api.unmap.dev/byod/ovl_aabbccddeeff/data",
  "overlay": "byod:ovl_aabbccddeeff"
}

GET /byod liste vos superpositions et répète les plafonds. DELETE /byod/{id} retire l'objet. GET /byod/{id}/data est le fichier lui-même (même clé). Un multipart file + name facultatif est aussi accepté. L'onglet données du tableau de bord fait la même chose avec la session du compte.

Les objets sont stockés à byod/{accountId}/{id}. Un autre compte ne peut ni lister, ni lire, ni supprimer les vôtres : la réponse est 404, pas une confirmation que l'id existe.

La peindre sur un style

Les superpositions GeoJSON se composent par le crochet overlays= existant :

GET /styles/muted.json?overlays=byod:ovl_aabbccddeeff,municipalities

unmap ajoute une source GeoJSON vers /byod/{id}/data?key= et des couches cercle et ligne palette seulement, au-dessus des routes et sous les étiquettes. Les données client restent visuellement dominantes. Un id manquant est un 400. PMTiles est stocké et servi à /byod/{id}/{z}/{x}/{y} pour que vous ajoutiez une source vectorielle vous-même; la composition de style ne devine pas le source-layer de l'archive, donc overlays=byod: sur un id PMTiles est un 400.

const map = new Unmap({
  key,
  style: "muted",
  overlays: ["byod:ovl_aabbccddeeff", "municipalities"],
});

Ce que ce n'est pas

  • Une base PostGIS par locataire, un indexeur de tuiles ou un moteur d'identification.
  • Une recherche sur vos attributs.
  • Un complément facturé avec un prix Stripe. L'usage est compté comme byod.
  • Un remplacement du catalogue de couches public.

Prochaines étapes

  • Couches pour les superpositions du catalogue, sans rien téléverser.
  • L'API de cartes pour la composition d'une superposition sur un style.
  • Forfaits et limites pour la taille et la rétention applicables.