Solea - API

Support non officiel de l'API de SOLEA, réseau de transport en commun de l'agglomération de Mulhouse (m2a). D'autres données annexes sont également récupérées. (Navette centre-ville de Mulhouse, voir la documentation).

[!WARNING]
Ce module n'est pas officiel et n'est pas affilié à SOLEA ni d'autres tiers. Les données récupérées peuvent ne pas être à jour ou incorrectes. De même, les auteurs de ce module ne sont pas responsables de l'utilisation que vous en faites. Ce code est donné "en l'état". Enfin, ceci ne constitue en aucune manière une documentation de l'API de SOLEA ni des autres services. Leurs formats de donnée peuvent d'ailleurs changer à tout moment. Afin de ne pas surcharger les serveurs de SOLEA, merci de ne pas abuser de ce module, surtout la fonctionnalité "itinéraire".

Solea

Solea-API

Ce module permet de récupérer entre autre :

• les prochains passages
• les lignes
• les arrêts
• le calcul d'itinéraire
• le trajet de la navette du centre-ville de Mulhouse

Note : La position de la navette n'est accessible que via un socket (non websocket) et n'est pas (et ne sera pas) implémentée. Cependant, une petite doc est disponible pour l'implémentation de cette fonctionnalité. (voir ici)

© 2025 NonozgYtb

Avec l'aide et en reprenant la structure d'un projet de : Maël Gangloff

Kind: global class
See: https://github.com/NonozgYtb/solea-api

• Solea
  • .getArrets() ⇒ Promise.<Array.<Arret>>
  • .getLignes() ⇒ Promise.<Array.<Ligne>>
  • .getLigne() ⇒ Promise.<Array.<LigneDetails>>
  • .getFicheHoraire(idPoteauSae, idLigne) ⇒ Promise.<FicheHoraireInitial>
  • .getPassages(idPoteauSae, idLigne) ⇒ Promise.<PassagesPoteau>
  • .getLignePicto(idLigne) ⇒ Promise.<string>
  • .getTADZone(idTADZone) ⇒ Promise.<string>
  • .getTADZonePicto(idTADZone) ⇒ Promise.<string>
  • .getInfosTrafic() ⇒ Promise.<Array.<InfoTrafic>>
  • .getTitres(type) ⇒ Promise.<Array.<Titre>>
  • .searchPOI(query) ⇒ Promise.<Array.<POI>>
  • .listPOI() ⇒ Promise.<Array.<POI>>
  • .searchAddress(query) ⇒ Promise.<Array.<Adresse>>
  • .searchItineraire(itineraireParams) ⇒ Promise.<ItineraireResult>
  • .getNavettePath() ⇒ Promise.<NavettePath>

Solea.getArrets() ⇒ Promise.<Array.<Arret>>

Lister les arrets du réseau de transport, avec les lignes qui y passent

Kind: static method of Solea
Returns: Promise.<Array.<Arret>> - Une liste contenant les arrets du réseau
Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getArrets().then(arrets => console.log(arrets))

Solea.getLignes() ⇒ Promise.<Array.<Ligne>>

Lister les lignes du réseau de transport

Kind: static method of Solea
Returns: Promise.<Array.<Ligne>> - Une liste contenant les lignes du réseau
Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getLignes().then(lignes => console.log(lignes))

Solea.getLigne() ⇒ Promise.<Array.<LigneDetails>>

Récupérer une ligne du réseau de transport

Kind: static method of Solea
Returns: Promise.<Array.<LigneDetails>> - Une liste contenant les lignes du réseau
Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getLigne("").then(ligne => console.log(ligne))

Solea.getFicheHoraire(idPoteauSae, idLigne) ⇒ Promise.<FicheHoraireInitial>

Récupérer la fiche horaire d'un arrêt en fonction d'une ligne

Kind: static method of Solea
Returns: Promise.<FicheHoraireInitial> - La fiche horaire de l'arrêt

| Param | Description | | --- | --- | | idPoteauSae | L'identifiant de l'arrêt | | idLigne | L'identifiant de la ligne |

Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getFicheHoraire(271, "C5")
    .then(fiche => console.log(fiche))

Les Champs ìdPoteau et idLigne sont disponibles à partir de getArrets.

Pour chaque lignes de getArrets :

• idPoteau correspond à sae
• idLigne correspond à ligne

Solea.getPassages(idPoteauSae, idLigne) ⇒ Promise.<PassagesPoteau>

Récupérer les prochains passages à un arrêt en fonction d'une ligne

Kind: static method of Solea
Returns: Promise.<PassagesPoteau> - Les prochains passages à l'arrêt

| Param | Description | | --- | --- | | idPoteauSae | L'identifiant de l'arrêt | | idLigne | L'identifiant de la ligne |

Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getPassages(271, "C5")
    .then(passages => console.log(passages))

Les Champs ìdPoteau et idLigne sont disponibles à partir de getArrets.

Pour chaque lignes de getArrets :

• idPoteau correspond à sae
• idLigne correspond à ligne

Solea.getLignePicto(idLigne) ⇒ Promise.<string>

Récupère le picto d'une ligne

Kind: static method of Solea
Returns: Promise.<string> - Le picto de la ligne en PNG (format texte base64)

| Param | Description | | --- | --- | | idLigne | L'identifiant technique de la ligne (ex: "C5", "94", "14") |

Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getLignePicto("C4")
 .then(rawdata => fs.writeFileSync('C4.png', Buffer.from(rawdata, 'base64')))

Solea.getTADZone(idTADZone) ⇒ Promise.<string>

Récupère les informations d'une zone TAD

Kind: static method of Solea
Returns: Promise.<string> - Le picto de la ligne en PNG (format texte base64)

| Param | Description | | --- | --- | | idTADZone | L'identifiant technique de la zone TAD (ex: 1, 106) |

Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getTADZone(106)
 .then(rawdata => console.log(rawdata))

Solea.getTADZonePicto(idTADZone) ⇒ Promise.<string>

Récupère le picto d'une zone TAD

Kind: static method of Solea
Returns: Promise.<string> - Le picto de la ligne en PNG (format texte base64)

| Param | Description | | --- | --- | | idTADZone | L'identifiant technique de la zone TAD (ex: 1, 106) |

Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getTADZonePicto(106, 96)
 .then(rawdata => fs.writeFileSync('106.png', Buffer.from(rawdata, 'base64')))

Solea.getInfosTrafic() ⇒ Promise.<Array.<InfoTrafic>>

Récupère les infos trafic impactants actuellement du réseau

Kind: static method of Solea
Returns: Promise.<Array.<InfoTrafic>> - Les informations trafic
Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getInfosTrafic().then((infos)=>console.log(infos))

Solea.getTitres(type) ⇒ Promise.<Array.<Titre>>

Récupère les titres de transport disponibles

Kind: static method of Solea
Returns: Promise.<Array.<Titre>> - Les titres de transport

| Param | Type | Default | Description | | --- | --- | --- | --- | | type | 'tickets' | 'abonnements' | 'both' | both | Le type de titre à récupérer ('tickets', 'abonnements' ou 'both') |

Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getTitres('tickets').then((tickets)=>console.log(tickets))

Solea.searchPOI(query) ⇒ Promise.<Array.<POI>>

Récupère les POI (Points d'Intérêt) à partir d'une recherche

Kind: static method of Solea
Returns: Promise.<Array.<POI>> - Les points d'intérêt

| Param | Description | | --- | --- | | query | La recherche à effectuer |

Solea.listPOI() ⇒ Promise.<Array.<POI>>

Liste tous les POI (Points d'Intérêt)

Kind: static method of Solea
Returns: Promise.<Array.<POI>> - Les points d'intérêt

Solea.searchAddress(query) ⇒ Promise.<Array.<Adresse>>

Récupère les adresses à partir d'une recherche

Kind: static method of Solea
Returns: Promise.<Array.<Adresse>> - Les adresses

| Param | Description | | --- | --- | | query | La recherche à effectuer |

Solea.searchItineraire(itineraireParams) ⇒ Promise.<ItineraireResult>

Liste toutes les adresses

Kind: static method of Solea
Returns: Promise.<ItineraireResult> - Les itinéraires

| Param | Description | | --- | --- | | itineraireParams | Les paramètres de l'itinéraire |

Solea.getNavettePath() ⇒ Promise.<NavettePath>

Récupère le tracé de la navette de Mulhouse en temps réel

Kind: static method of Solea
Returns: Promise.<NavettePath> - Les données de la navette
Example

const { Solea } = require('@nonozgytb/solea-api')

Solea.getNavettePath().then((navette)=>console.log("Le tracé actuel en point GPS de la navette :",navette.data))

Position de la Navette de Mulhouse, par Soléa (Transports Mulhouse Agglomération)

Préambule :

L'utilisateur peut récupérer via l'application Soléa la position de la (des) navette(s) actuellement présente dans le centre ville de Mulhouse. Cela ce fait via un socket utilisé par l'application Android. Etant un socket TCP, la récupération ne peut pas se faire directement sur une page web. Le processus de récupération des posiitons des navettes est de ce fait complètement différent.

C'est pour cela que ce module n'inplémente pas (et n'implémentera jamais) la récupération de la position des navettes.

Cependant, voici quelques informations pouvant être utiles :

• Adresse du serveur : lanavette.mulhouse.fr
• Port du serveur : 18099
• Type de socket : TCP

Le type retourné est NavetteSocketData :

export interface NavettePosition {
  id: string
  lng: number
  lat: number
  tmstp: number
  old?: boolean
}

export type NavetteSocketData = {
  [id: string]: NavettePosition
}

De plus, lors du premier message reçu par le serveur via le socket, il n'y a pas de champ "old", sinon il y a un champ "old" qui semble rester à false tout le temps.

(Ex. : {"5868f5dbf6105d2c":{"id":"5868f5dbf6105d2c","lng":7.332557,"lat":47.747186,"tmstp":1732365820,"old":false}})

Exemple de code pour récupérer les données :

socat STDIO TCP4:lanavette.mulhouse.fr:18099

const net = require('net')
const client = new net.Socket()

client.connect(18099, 'lanavette.mulhouse.fr', () => {
  console.log('Connecté !')
})
client.on('data', (data) => {
  const json = JSON.parse(data.toString())
  console.log('Nouvelle position :', json)
})
client.on('close', () => {
  console.log('Connexion fermée')
})
// Fermeture de la connexion après 10s
setTimeout(() => {
  client.destroy()
}, 10000)

© 2025 NonozgYtb

Avec l'aide et en reprenant la structure d'un projet de : Maël Gangloff