ZENITHIS GEOENGINE · DOCUMENTATION

Des contrats clairs,
des données traçables.

Les statuts indiquent ce qui répond actuellement. GeoEngine, Places et Aviation ont chacun leurs contrats, sources et limites documentés.

GEOENGINE · OPENAPI 3.1

Recherche, lieux et itinéraires.

API géographiques en lecture seule, alimentées par Photon et les données OpenStreetMap auto-hébergées. Les formats et statuts ci-dessous sont décrits dans le contrat GeoEngine.

GET /v1/search

Recherche géographique

Recherche textuelle avec paramètres q, limit et lang. Les résultats sont retournés en GeoJSON avec leurs attributions.

Tester la recherche →
GET /v1/reverse

Géocodage inversé

Résoudre une position WGS84 avec la latitude lat et la longitude lon.

Tester le reverse →
GET /v1/distance

Distance géodésique

Mesure à vol d’oiseau entre deux coordonnées. Ce calcul ne suit pas le réseau routier.

Calculer une distance →
GET /v1/route · Canary

Routage limité

GET et POST sont disponibles en voiture, marche et vélo. La durée est estimée sans trafic en temps réel. Géométrie polyline6 et instructions sont disponibles en réponse.

Essayer un itinéraire →
PLACES · GET /v1/places

Recherche de lieux active

Les catégories de lieux sont chargées par défaut sur la carte. Si le catalogue éditorial vérifié est vide, la recherche bascule sur les fiches communautaires OpenStreetMap via Photon, avec attribution ODbL. La publication de nouvelles fiches vérifiées reste séparée et ne bloque pas la carte.

Documentation Places →
GET /health

État du service

Le contrôle GeoEngine permet de vérifier l’état général de l’API et sa connexion à la base spatiale.

Vérifier la santé ↗
CARTOGRAPHIE · FLYINFOS

Intégration FlyPool

Correspondance des API, formes JSON, limitations Aviation et adaptations requises pour les clients FlyPool.

Lire l’audit de compatibilité →

Comportement client conseillé

Utilisez HTTPS, gérez les réponses HTTP non réussies, annulez les requêtes devenues obsolètes et appliquez une temporisation sur les réponses 429 et 503. Le routage est un canary sans garantie commerciale.

Recherche de Douala avec curl

Exemple de requête de lecture vers GeoEngine.

curl -fsS 'https://map.zenithis.tech/v1/search?q=Douala&limit=3'

GeoJSON encode les coordonnées dans l’ordre longitude, latitude. Respectez l’attribution affichée par les sources utilisées.

Itinéraire canary Douala

Le mode peut être auto, pedestrian ou bicycle. Le trajet et sa durée dépendent des données routières disponibles.

curl -fsS 'https://map.zenithis.tech/v1/route?from_lat=4.0511&from_lon=9.7679&to_lat=4.0735&to_lon=9.6769&costing=auto'
AVIATION DATA ENGINE

Un contrat distinct pour l’aéronautique.

Le portail Aviation expose des observations ouvertes et un référentiel d’aéroports. Ces données ne constituent ni un système de suivi certifié ni des horaires commerciaux.

GET /aviation/open/v1/aircraft

Positions ADS-B observées

Flux communautaire à fraîcheur variable dans quatre zones : Nice, Paris, Douala et Yaoundé. Un résultat vide n’indique pas une absence de vols.

Voir l’aperçu live →
GET /aviation/open/v1/weather/{icao}

Météo METAR / TAF

Produits d’observation et de prévision disponibles pour cinq stations. La réponse inclut les heures de réception et l’état de fraîcheur.

Contrat OpenAPI Aviation →
GET /aviation/reference

Référentiel aéroports

Recherche du référentiel OurAirports avec provenance. Ce jeu de données ne fournit ni horaires, ni porte d’embarquement, ni statut commercial.

Documentation et exemples →
GET /aviation/status/

État, sources et couverture

Vérifiez la disponibilité des sources, les zones couvertes et leurs restrictions avant toute intégration.

Voir l’état Aviation →

Pas d’horaires officiels

Les sources publiées ne confirment pas les départs, arrivées, retards, annulations, portes ou numéros de vols commerciaux. Les horaires éventuellement affichés par des sites externes sont fournis par leurs éditeurs et non vérifiés par Zenithis. Ces données ne sont pas adaptées à la navigation aérienne.

LICENCES ET ATTRIBUTION

Respecter les sources fait partie de l’intégration.

Les licences diffèrent selon chaque fournisseur et jeu de données. Affichez les crédits requis et consultez la page de couverture avant redistribution.

RESSOURCES UTILES
GeoEngine    /openapi.json
Places       /places/docs/
Aviation     /aviation/docs/
Données      /aviation/status/
Playground   /playground/
Vérifiez la licence et la fraîcheur par source.