diff --git a/public/css/docs.css b/public/css/docs.css index 497320b..a10e274 100644 --- a/public/css/docs.css +++ b/public/css/docs.css @@ -107,10 +107,29 @@ @media (max-width: 760px) { .docs-wrap { flex-direction: column; + align-items: stretch; } .docs-side { position: static; - flex: auto; + flex: none; + width: 100%; + } + .docs-body { + flex: none; + width: 100%; + min-width: 0; + } + .docs-body pre { + max-width: 100%; + } + .docs-body table { + display: block; + width: 100%; + overflow-x: auto; + -webkit-overflow-scrolling: touch; + } + .docs-body :not(pre) > code { + overflow-wrap: anywhere; } } diff --git a/src/docs.ts b/src/docs.ts index b3177d9..3f3d6e6 100644 --- a/src/docs.ts +++ b/src/docs.ts @@ -28,7 +28,7 @@ function layout(title: string, description: string, body: string, sidebar: strin - + diff --git a/src/maxspeed-doc.md b/src/maxspeed-doc.md index 0fee935..da265ea 100644 --- a/src/maxspeed-doc.md +++ b/src/maxspeed-doc.md @@ -24,12 +24,21 @@ de référence** : ajoutez ici toute nouvelle API. # 1. API Maxspeed -Découvre la **limitation de vitesse** (maxspeed) d'un point géographique en France -et en Europe, calculée depuis les données OpenStreetMap. +Découvre la **limitation de vitesse** (maxspeed) d'un point géographique, calculée +depuis les données OpenStreetMap. **Couverture : l'Europe uniquement** (l'effort de +production actuel porte sur ce continent ; aucune ville hors Europe n'est indexée). La base est une grille de **90 518 792 points** échantillonnés le long des routes -(europa entière), à une résolution d'environ **0,8 mètre**. Chaque point porte la -vitesse maximale de la route sur laquelle il se trouve. +de l'Europe entière, à une résolution d'environ **0,8 mètre**. Chaque point porte +la vitesse maximale de la route sur laquelle il se trouve. + +> **⚠️ Données à titre indicatif.** Ces valeurs proviennent d'un traitement +> automatisé de cartes collaboratives : elles reflètent l'état des données à la +> **mi-août 2026** et ne sont **pas garanties à 100 %**. Les limitations peuvent +> être obsolètes, incomplètes ou erronées — surtout **en ville**, où les +> panneaux changent fréquemment. Vérifie toujours auprès des panneaux réels ou +> des sources officielles avant toute décision. Ne convient pas à un usage +> réglementaire ou juridique. **Base URL** (racine de l'API) : @@ -107,7 +116,7 @@ GET /api/maxspeed/route?coords=2.307,48.87;2.404,48.66;2.589,48.66 - En-tête `Content-Type: application/json; charset=utf-8`. - CORS ouvert : `Access-Control-Allow-Origin: *` (appelable depuis n'importe quel site). - Cache HTTP : `public, max-age=300` (5 min) — les valeurs ne changent qu'avec une - mise à jour du jeu de données (hebdomadaire). + mise à jour du jeu de données (actuellement issu de la mi-août 2026). - Les réponses sont compactes (pas de champs redondants). --- @@ -157,14 +166,15 @@ Benchmarks **réels** effectués sur la machine de production (ARM 64, 4 cœurs, | Lookup point unique | **~0,10 ms** | ~9 900 req/s | | Lookup par point d'un tracé | **~0,11 ms** | ~9 000 req/s | -Chiffres clés du jeu de données : +Chiffres clés du jeu de données (Europe, mi-août 2026) : ``` Points maxspeed : 90 518 792 Cellules (tuiles) : 5 104 Résolution : ~0,8 m (échantillonnage tous les 40 m le long des routes) Taille grille : 370 Mo (compressé) -Source : OpenStreetMap (planet hebdo) +Source : OpenStreetMap (données Europe) +Vintage : mi-août 2026 ``` ---