GEONIA EN Connexion
API v1

Posez vos questions par programme

Tout ce que montre la carte est disponible en JSON ou en CSV : les mêmes questions, les mêmes paramètres et la même provenance. Les données ouvertes ne demandent aucune clé ; les données sous licence du GVCdtLab exigent une clé API liée à un compte autorisé.

Référence interactive (OpenAPI) openapi.json Créer un compte

Démarrage en 30 secondes

1 · Lister les questions

curl -s https://geonia.warin.ca/api/v1/questions?lang=fr

2 · Lire les paramètres

curl -s https://geonia.warin.ca/api/v1/questions/macro-map

3 · Obtenir la réponse

curl -s "https://geonia.warin.ca/api/v1/questions/macro-map/answer?indicator=FP.CPI.TOTL.ZG&year=2024"

Exemples complets

Python — l'inflation mondiale en 2024, triée

import requests

base = "https://geonia.warin.ca/api/v1"
ans = requests.get(f"{base}/questions/macro-map/answer",
                   params={"indicator": "FP.CPI.TOTL.ZG", "year": "2024", "lang": "fr"}).json()
print(ans["headline"])
for row in ans["table"]["rows"][:10]:
    print(row["name"], row["value"])
for p in ans["provenance"]:
    print(p["name"], p["license"], p["fetched_at"], p["cache"])

R — redirection commerciale du Canada (sous licence)

library(httr2)
ans <- request("https://geonia.warin.ca/api/v1/questions/trade-redirection/answer") |>
  req_url_query(dropped_importer = "United States", dropped_exporter = "China", product = "all") |>
  req_headers("X-API-Key" = Sys.getenv("GEONIA_API_KEY")) |>
  req_perform() |>
  resp_body_json()
ans$headline

SQL — interroger directement l'entrepôt (sous licence)

curl -s -X POST https://geonia.warin.ca/api/v1/sql \
  -H "X-API-Key: $GEONIA_API_KEY" -H "Content-Type: application/json" \
  -d '{"query": "SELECT product_label, count(*) AS markets FROM cca_export WHERE cca_tau > 0 GROUP BY 1 ORDER BY 2 DESC LIMIT 10"}'

Données brutes en direct

curl -s "https://geonia.warin.ca/api/v1/data/wdi/SP.POP.TOTL?countries=CAN;MEX;USA&date=2000:2024"
curl -s "https://geonia.warin.ca/api/v1/data/fred/DEXCAUS?start=2024-01-01"
curl -s "https://geonia.warin.ca/api/v1/data/imf/NGDP_RPCH?countries=CAN,USA"
curl -s "https://geonia.warin.ca/api/v1/data/bis/policy-rates?start=2024-01"

Points de terminaison

GET/api/v1/questions
Catalogue par direction de recherche
GET/api/v1/questions/{id}
Paramètres, sources, méthode et mises en garde
GET/api/v1/questions/{id}/options/{param}
Valeurs valides d'un paramètre dynamique
GET/api/v1/questions/{id}/answer
Réponse : titre, carte, graphique, tableau, notes, provenance (format=json|csv)
GET/api/v1/sources
Sources, licences et classes d'accès
GET/api/v1/places/{level}/{code}
Indicateurs d'un lieu à son niveau : world/WLD, region/SSF, economy/KEN, subnational/CA-QC (indicators=a,b,c)
GET/api/v1/geo/countries
Frontières (GeoJSON)
GET/api/v1/layers/ports · /layers/mines
Couches de contexte (GeoJSON)
GET/api/v1/data/{wdi|fred|imf|bis}/…
Accès direct aux sources publiques, mis en cache avec provenance
GET/api/v1/local/summary · /firms · /employment · /supply-chain · /traffic?bbox=w,s,e,n
Échelle de la rue : entreprises (REQ), industries et quotients de localisation, chaînes d'approvisionnement du Québec, grille d'emplois estimés, circulation MTMD
GET/api/v1/local/gdp?bbox=w,s,e,n&calibrate=true
PIB du Québec par cellule, réparti à partir du PIB par industrie selon les emplois du REQ et calé sur le PIB par RMR de StatCan ; les cellules s'affinent avec la boîte
GET/api/v1/units?bbox=w,s,e,n&level=da|ct|csd|iris|com&indicator=&sector=
Unités de recensement à l'écran — Québec (REQ) ou Île-de-France (SIRENE, IRIS et communes) — avec indicateurs, PIB estimé, statistiques agrégées et séries trimestrielles
GET/api/v1/panel/sirene?level=idf|com|iris&uid=|bbox=&start=2000Q1&format=csv
Panel trimestriel des établissements SIRENE d'Île-de-France (actifs, créations, fermetures, emplois salariés), plus récent d'abord
GET/api/v1/panel/req?level=qc|csd|ct|da&uid=|bbox=&start=1996Q1&format=csv
Panel trimestriel du REQ (actives, entrées, sorties, emplois) par unité de recensement et secteur, plus récent d'abord
GET/api/v1/local/weather?lat=&lon=
Météo actuelle et 3 jours (Open-Meteo)
GET/api/v1/live/vessels?bbox=
Navires AIS en direct (clé aisstream.io requise)
GET/api/v1/data/statcan/search?q= · /{table} · /{table}/metadata · /{table}/series?members=a|b
N'importe quel tableau de Statistique Canada, comme le fait le paquet statcanR
GET/api/v1/sql/schema
Tables de l'entrepôt (sous licence)
POST/api/v1/sql
Un SELECT en lecture seule, 5 000 lignes, 15 s (sous licence)

Principes