Metroid

An android public transportation itinerary planner

News

Metroid 1.0 submitted for the Android Developer Challenge
April 14, 2008

Contribute a City

Metroid is based on maps. A map encapsulates all data about a city : transportation lines, frequency, stops...

Metroid maps use the mtd file extension. These mtd files are compact and use up very little disk place. They are to be transfered and used on Android devices. 

However, the mtd files must be generated with an utility specially created for that purpose. The data used to generate these files is based on a very simple text format. The following guide will show you the basics of that format. Metroid is a community driven project and needs your help to succeed. The more cities are covered, the better it is. So please don't hesitate to contribute and if you have any question or suggestion, feel free to contact us at webmaster@ycsoft.org.

If you want to help supporting a particular city, please prepare the data as explained below and send it to us by email at webmaster@ycsoft.org. We'll reply as quickly as possible with the generated mtd files. And if you agree, your city will be added to the central repository and thus be available to the whole community.

Metroid data format


The following example shows the Metroid data for the first two lines for Paris' subway system.

.City : Paris
.Mean : Metro
.Language : en
.Line : Ligne 1
.TotalTime : 35
.Frequency : 4
.Stops
Château de Vincennes
Bérault
Saint-Mandé
Porte de Vincennes
Nation
Reuilly - Diderot
Gare de Lyon
Bastille
Saint-Paul
Hôtel de Ville
Châtelet
Louvre - Rivoli
Palais Royal - Musée du Louvre
Tuileries
Concorde
Champs-Élysées - Clemenceau
Franklin D. Roosevelt
George V
Charles de Gaulle - Étoile
Argentine
Porte Maillot
Les Sablons
Pont de Neuilly
Esplanade de La Défense
La Défense
.Line : Ligne 2
.Frequency : 4
.TotalTime : 35
.Stops
Nation
Avron
Alexandre Dumas
Philippe Auguste
Père Lachaise
Ménil
montant
Couronnes
Belleville
Colonel Fabien
Jaurès*Stalingrad
La Chapelle
Barbès - Rochechouart
Anvers
Pigalle
Blanche
Place de Clichy
Rome
Villiers
Monceau
Courcelles
Ternes
Charles de Gaulle
Étoile
Victor Hugo
Porte Dauphine

Most transportation system around the world are divided into Lines which in turn are a succession of stations(or stops). The Metroid data format follow that convention. The file starts with the .City specifying the city then the keyword .Mean telling which transportation mean is concerned. The mean could either be Metro(for Subway), Bus or Both (Metro + Bus).

These are general information about the map. They are then followed with as many Line data sections as necessary. Lines data begin with the keyword  .Line followed by a : and the name of the line. The .TotalTime keyword specifies  the number of minutes it takes to travel from the first stop in the line to the last one. It is used to compute the average travel between two adjacent stops. If not specified, it is assumed to be 5 min.

The .Frequency keyword indicates how often the bus (or the metro) passes.

Finally, the keyword .Stops must be added and followed with the list of all stops in the line.