Une gare par identifiant OSM
À savoir. Snapshot OpenStreetMap daté, sous ODbL. Noms et villes absents : null. Inclut des sites inactifs ou projetés ; la desserte voyageurs et les liaisons actuelles ne sont pas vérifiées.
Comprendre la réponse
data: Les résultats demandés, sous forme d’objet ou de liste.
meta: Sources, licence et dates du jeu de données. null signifie une valeur inconnue ou indisponible.
API v2 est le chemin de référence. Les anciens chemins /api/v1 restent des alias de compatibilité du comportement actuellement publié, pagination comprise ; aucune date de suppression n’est fixée.
Champs renvoyés 27
[] désigne chaque élément d’une liste. null signifie inconnu ou indisponible, jamais zéro. La langue du guide ne traduit pas les valeurs des sources.
dataobjectRésultat demandé : objet unique ou liste.
data.idstringIdentifiant de l’objet OSM principal, pas un code ONCF ou UIC.
data.namestring | nullNom de la ressource, éventuellement réparti par langue.
data.namesobjectNoms explicitement renseignés par langue dans OSM ; aucune traduction générée.
data.names.arstring | nullValeur en arabe ; null si aucune traduction n’est fournie.
data.names.frstring | nullValeur en français ; null si aucune traduction n’est fournie.
data.names.enstring | nullValeur en anglais ; null si aucune traduction n’est fournie.
data.aliasesstring[]Autres noms de la même ressource, utiles pour la reconnaître ou la rechercher.
data.typestringstation : gare ; halt : petit arrêt ferroviaire.
Valeurs acceptées:
"station""halt"data.citystring | nullVille indiquée par addr:city ou is_in:city dans OSM ; null si absente.
data.operatorstring | nullExploitant renseigné dans OSM, sans confirmation officielle actuelle.
data.networkstring | nullRéseau renseigné dans OSM, s’il existe.
data.locationobjectCoordonnées géographiques de la source, lorsqu’elles sont disponibles.
data.location.latitudenumberLatitude WGS 84 en degrés décimaux : nord positif, sud négatif.
data.location.longitudenumberLongitude WGS 84 en degrés décimaux : est positif, ouest négatif.
data.location.methodstringosm_point : point source ; bounding_box_center : centre de l’emprise, pas une entrée.
Valeurs acceptées:
"osm_point""bounding_box_center"data.osm_statusstringCycle de vie explicite dans OSM ; unknown ne confirme pas l’ouverture.
Valeurs acceptées:
"unknown""disused""abandoned""construction""proposed""demolished"data.wikidata_idstring | nullIdentifiant Wikidata présent dans OSM, sans enrichissement externe.
data.passenger_servicenullnull : aucune desserte voyageurs actuelle vérifiée.
Valeurs acceptées:
nulldata.connectionsnullnull : liaisons indisponibles, pas une liste vide prouvant leur absence.
Valeurs acceptées:
nulldata.sourcesobject[]Objets OSM justifiant cette fiche ; le premier détermine son identifiant et sa position.
data.sources[].osm_typestringType d’objet OpenStreetMap : node, way ou relation.
Valeurs acceptées:
"node""way""relation"data.sources[].osm_idintegerIdentifiant numérique OSM, à associer à osm_type.
data.sources[].versionintegerVersion de l’objet OSM dans cet extrait.
data.sources[].updated_atstringDernière modification OSM de cet objet ; pas une vérification de terrain.
data.sources[].urlstringLien vers l’objet OSM, dont la version en ligne peut avoir évolué.
data.sources[].fieldsstring[]Champs fournis par cet objet source dans la fiche normalisée.
Structure des données
{
"type": "object",
"additionalProperties": false,
"required": [
"data",
"meta"
],
"properties": {
"data": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"name",
"names",
"aliases",
"type",
"city",
"operator",
"network",
"location",
"osm_status",
"wikidata_id",
"passenger_service",
"connections",
"sources"
],
"properties": {
"id": {
"type": "string",
"pattern": "^osm-(node|way|relation)-[1-9][0-9]*$"
},
"name": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"names": {
"type": "object",
"additionalProperties": false,
"required": [
"ar",
"fr",
"en"
],
"properties": {
"ar": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"fr": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"en": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
}
}
},
"aliases": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"type": {
"type": "string",
"enum": [
"station",
"halt"
]
},
"city": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
],
"description": "Explicit OSM addr:city or is_in:city, not a geocoded administrative assignment."
},
"operator": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"network": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"location": {
"type": "object",
"additionalProperties": false,
"required": [
"latitude",
"longitude",
"method"
],
"properties": {
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"method": {
"type": "string",
"enum": [
"osm_point",
"bounding_box_center"
]
}
}
},
"osm_status": {
"type": "string",
"enum": [
"unknown",
"disused",
"abandoned",
"construction",
"proposed",
"demolished"
],
"description": "Explicit source lifecycle only; unknown is not confirmation of current service."
},
"wikidata_id": {
"anyOf": [
{
"type": "string",
"pattern": "^Q[1-9][0-9]*$"
},
{
"type": "string",
"nullable": true,
"enum": [
null
]
}
]
},
"passenger_service": {
"type": "string",
"description": "Current passenger service is not verified.",
"nullable": true,
"enum": [
null
]
},
"connections": {
"type": "string",
"description": "Unavailable, not an empty set of connections. No timetable feed is integrated.",
"nullable": true,
"enum": [
null
]
},
"sources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"osm_type",
"osm_id",
"version",
"updated_at",
"url",
"fields"
],
"properties": {
"osm_type": {
"type": "string",
"enum": [
"node",
"way",
"relation"
]
},
"osm_id": {
"type": "integer",
"minimum": 1
},
"version": {
"type": "integer",
"minimum": 1
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "OSM edit timestamp, not a verification of current service."
},
"url": {
"type": "string",
"format": "uri"
},
"fields": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
}
}
}
}
},
"meta": {
"type": "object",
"additionalProperties": false,
"required": [
"dataset",
"total",
"license",
"license_url",
"attribution",
"snapshot_at",
"retrieved_at",
"transformation_version",
"source_record_count",
"snapshot_record_count",
"scope",
"limitations",
"sources"
],
"properties": {
"dataset": {
"enum": [
"osm-geofabrik-morocco-rail"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"license": {
"enum": [
"ODbL-1.0"
]
},
"license_url": {
"enum": [
"https://opendatacommons.org/licenses/odbl/1-0/"
]
},
"attribution": {
"enum": [
"© OpenStreetMap contributors"
]
},
"snapshot_at": {
"enum": [
"2026-11-13T21:22:20Z"
]
},
"retrieved_at": {
"enum": [
"2026-11-14"
]
},
"transformation_version": {
"enum": [
"1.0.0"
]
},
"source_record_count": {
"enum": [
178
]
},
"snapshot_record_count": {
"enum": [
151
]
},
"scope": {
"type": "string",
"minLength": 1
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"sources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"producer",
"source_url",
"resource_url",
"license",
"source_updated_at",
"sha256"
],
"properties": {
"producer": {
"type": "string",
"minLength": 1
},
"source_url": {
"type": "string",
"format": "uri"
},
"resource_url": {
"type": "string",
"format": "uri"
},
"license": {
"enum": [
"ODbL-1.0"
]
},
"source_updated_at": {
"type": "string",
"format": "date-time"
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
}
}
}
}
}
}Sources et pagination 20
metaobjectContexte du résultat : sources, dates, licence et pagination si applicable.
meta.datasetstringNom du jeu de données auquel appartient le résultat ou la source.
Valeurs acceptées:
"osm-geofabrik-morocco-rail"meta.totalintegerNombre de résultats correspondant aux filtres, avant pagination ; pas la taille de cette page.
meta.licensestringLicence de réutilisation. mixed signifie des licences différentes : consultez chaque source.
Valeurs acceptées:
"ODbL-1.0"meta.license_urlstringLien vers les conditions de la licence ; null si aucune URL n’est fournie.
Valeurs acceptées:
"https://opendatacommons.org/licenses/odbl/1-0/"meta.attributionstringMention d’attribution requise pour les données OSM.
Valeurs acceptées:
"© OpenStreetMap contributors"meta.snapshot_atstringDate et heure de l’extrait OSM, distinctes des modifications individuelles.
Valeurs acceptées:
"2026-11-13T21:22:20Z"meta.retrieved_atstringDate de récupération du fichier source par le projet ; pas la date des observations.
Valeurs acceptées:
"2026-11-14"meta.transformation_versionstringVersion des règles de conversion du jeu de données ; distincte de l’API.
Valeurs acceptées:
"1.0.0"meta.source_record_countnumberNombre de lignes dans la source, avant les éventuels filtres de l’API.
Valeurs acceptées:
178meta.snapshot_record_countnumberNombre de fiches après filtrage et regroupements, avant les filtres de la requête.
Valeurs acceptées:
151meta.scopestringPérimètre couvert par le jeu de données ; ne présume pas une couverture universelle.
meta.limitationsstring[]Limites connues de la source ou de la couverture ; à lire avant d’utiliser les données.
meta.sourcesobject[]Origine et licence de l’extrait téléchargé.
meta.sources[].producerstringOrganisme qui publie la donnée originale.
meta.sources[].source_urlstringPage de présentation ou de publication de la source.
meta.sources[].resource_urlstringLien vers le fichier ou la ressource utilisée.
meta.sources[].licensestringLicence de réutilisation. mixed signifie des licences différentes : consultez chaque source.
Valeurs acceptées:
"ODbL-1.0"meta.sources[].source_updated_atstringDernière mise à jour annoncée par la source ; pas la date de récupération.
meta.sources[].sha256stringEmpreinte SHA-256 du fichier PBF source complet.
Erreurs
400: Paramètre invalide ou manquant.404: Ressource introuvable.
Les erreurs renvoient error.code, error.message et error.request_id.
errorobjectDétails d’une requête échouée ; remplace data et meta.
error.codestringCode stable de l’erreur, par exemple RESOURCE_NOT_FOUND ; à utiliser dans votre logique.
error.messagestringExplication lisible de l’erreur ; utilisez code pour la logique de votre application.
error.request_idstringIdentifiant du traitement de cette requête, utile pour retrouver un problème.