fix(docs): contenu factuel — couverture Europe uniquement (pas 'planet'), vintage mi-août 2026, disclaimer 'à titre indicatif, non garanti à 100 % (surtout en ville)', suppression des mentions hebdomadaire non fondées ; fix overflow mobile docs (flex column stretch + table/pre scroll).

This commit is contained in:
riricdev 2026-09-07 15:55:12 +02:00
commit 4279eb0f6d
3 changed files with 38 additions and 9 deletions

View file

@ -107,10 +107,29 @@
@media (max-width: 760px) { @media (max-width: 760px) {
.docs-wrap { .docs-wrap {
flex-direction: column; flex-direction: column;
align-items: stretch;
} }
.docs-side { .docs-side {
position: static; 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;
} }
} }

View file

@ -28,7 +28,7 @@ function layout(title: string, description: string, body: string, sidebar: strin
<link rel="shortcut icon" href="/favicon.ico" /> <link rel="shortcut icon" href="/favicon.ico" />
<link rel="me" href="https://piaille.fr/@zektyc" /> <link rel="me" href="https://piaille.fr/@zektyc" />
<link rel="stylesheet" href="/css/style.css?v=8" /> <link rel="stylesheet" href="/css/style.css?v=8" />
<link rel="stylesheet" href="/css/docs.css?v=2" /> <link rel="stylesheet" href="/css/docs.css?v=3" />
<script src="/js/theme.js" defer></script> <script src="/js/theme.js" defer></script>
<script src="/js/global.js?v=1" defer></script> <script src="/js/global.js?v=1" defer></script>
<script src="/js/components.js?v=6" defer></script> <script src="/js/components.js?v=6" defer></script>

View file

@ -24,12 +24,21 @@ de référence** : ajoutez ici toute nouvelle API.
# 1. API Maxspeed # 1. API Maxspeed
Découvre la **limitation de vitesse** (maxspeed) d'un point géographique en France Découvre la **limitation de vitesse** (maxspeed) d'un point géographique, calculée
et en Europe, calculée depuis les données OpenStreetMap. 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 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 de l'Europe entière, à une résolution d'environ **0,8 mètre**. Chaque point porte
vitesse maximale de la route sur laquelle il se trouve. 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) : **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`. - En-tête `Content-Type: application/json; charset=utf-8`.
- CORS ouvert : `Access-Control-Allow-Origin: *` (appelable depuis n'importe quel site). - 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 - 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). - 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 point unique | **~0,10 ms** | ~9 900 req/s |
| Lookup par point d'un tracé | **~0,11 ms** | ~9 000 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 Points maxspeed : 90 518 792
Cellules (tuiles) : 5 104 Cellules (tuiles) : 5 104
Résolution : ~0,8 m (échantillonnage tous les 40 m le long des routes) Résolution : ~0,8 m (échantillonnage tous les 40 m le long des routes)
Taille grille : 370 Mo (compressé) Taille grille : 370 Mo (compressé)
Source : OpenStreetMap (planet hebdo) Source : OpenStreetMap (données Europe)
Vintage : mi-août 2026
``` ```
--- ---