source: subversion/applications/utils/import/gml2osm/README @ 5763

Last change on this file since 5763 was 3721, checked in by isortega, 13 years ago

Added gml2osm import utility - use it when importing data from GML format.
It's able to reuse nodes/segments, and translates a subset of the EGM data dictionary into OSM map features.

File size: 2.4 KB
Line 
1GML 2 OSM
2=========
3
4
5Overview
6--------
7
8This set of scripts is able to convert data from a GML file into a OSM file, suitable for loading into JOSM and uploading.
9
10GML stands for "Geographic Markup Language", and is a OpenGeoSpatial Consortium standard. It only cares about the geometry of the data.
11
12Metadata ("tags") are not defined by GML; the definition of the meanings of the metadata (i.e. xml nodes in a namespace different than wfs or gml) are defined somewhere else. For example, the EuroGeographics group publishes the EuroGlobalMap data catalogue.
13
14
15
16Features
17--------
18
19Features, as v0.2, include:
20- Import of Points, Linestrings, MultiLinestrings and Multipolygons
21- Detection of nodes and segments used more than once: no data duplication
22- Partial EGM metadata translation to OSM Map Features: Roads, Railways, Ferries, Populated places
23
24
25Features not implemented yet:
26- Support of polygons with inner hulls
27- Full EGM metadata translation
28- Add custom tags to every piece of data, to mark attribution of the data source.
29
30
31Usage
32-----
33
34You'll need a recent version of PHP, along with the SimpleXML extension enabled, to run these scripts. You will need the "cs2cs" executable (part of the "proj4" suite) in order to project the data from a coordinate system to another. Run as follows:
35
36php5 gml2osm foobar.gml baz foobar.osm
37
38Where:
39foobar.gml is the input GML file
40foobar.osm is the output GML file
41"baz" is the data namespace. Peek at the GML file, and you should see another namespace, not 'gml' and not 'wfs'; feed that to the script.
42
43
44This has been tested against GML data obtained from the IDEE WFS (www.idee.es -> "descarga de datos"). There is no warranty that the script will work with GML data from another provider.
45
46
47Legal Stuff
48-------
49
50gml2osm scripts
51Copyright (C) 2007 Iván Sánchez Ortega <ivansanchez@escomposlinux.org
52
53This program is free software: you can redistribute it and/or modify
54it under the terms of the GNU General Public License as published by
55the Free Software Foundation, either version 3 of the License, or
56(at your option) any later version.
57
58This program is distributed in the hope that it will be useful,
59but WITHOUT ANY WARRANTY; without even the implied warranty of
60MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
61GNU General Public License for more details.
62
63You should have received a copy of the GNU General Public License
64along with this program.  If not, see <http://www.gnu.org/licenses/>.
65
Note: See TracBrowser for help on using the repository browser.