Mapgen User`s manual
Contents
1. 10 Icon File name 11 Icon size In pixels 12 FromScale INTEGER 13 ToScale INTEGER Ways Name Values Description 1 ke see wiki y values can be separated by a I see wiki 1 kK gt ie an asterisk may be used as a wild card values can be separated by a I 3 color see separate list the fill color 4 thickness INTEGER thickness of line 5 dash style 1 4 10 14 20 23 determines the style of the dashes forming the way Border Border color for the way Only valid 1f color TEA border thickness is gt 0 7 AOON INTEGER Border thickness for the way thickness 8 il Oor 0 area will not be filled 1 area will be filled key where value will be used as label text entries can be separated 9 label by or AND PRIO special keys _lon and _lat 10 label color see below 11 label size INTEGER font size 12 ae o see below family 13 label offset INTEGER offset for label text in y direction negative up positive down 14 legend 0 or entry for automatic legend O no l yes applies for areas closd ways areas tagged 15 base layer Oorl with are drawn as background first use for landuse natural etc 16 Icon TEXT Fill icon for area SVG and PNG supported 17 FromScale INTEGER 16 ToScale INTEGER If you want to use SVG files as area tile patterns inkscape is mandatory Using _lon and _lat you could nicely label a natural peak using a second rule for elevation 1 e A ber Feld2. This can be changed by using the coordsexp parameter The value given here is the power of 10 2 means 0 01 degrees 2 means 10 degrees And of course the color can be changed coords turn on coordinates grid coordsexp INTEGER degrees to the power of ten for grid distance DEFAULT 2 equals 0 01 degrees coordscolor TEXT set color of coordinates grid RL h CAS UA Beta data qe pr aser ap ofa nail ral ede P T Epnrad Ad m uer Seh le 1 Debug Verbose will turn on lots of information to be printed while program executes This is mostly done for debug purposes verbose If you want to print a map only containing multipolygons you can specify so This is also a debug function although a graphical one multionly draws only areas of multipolygons for test purposes
3. Mapgen by Gary68 User s manual Version 0 13 March 2010 j Qa Table of Contents AMOUR i ne 3 A A O E 3 AMA AAA ad 3 Basto parametro eden alee 4 OPUS de aos 4 USAGE CX AIMPICS saonat A E a e T 4 M psizeand the ik cuicce a T 5 Advanced parameters untada E eaten ean tena epee oe neas nation ante 5 Sens a SCANS tonitle alone a detona cas 6 A MP a Genta aaa ndeh Snsacuametenee 7 RO 7 NOS die N 7 O PUE In a E 8 A O eS Nee nme ee 10 ROUE ICONS hese ac es A O teem N as 11 A A A IN 12 A antadees 13 OAS WAY o ica ic 13 FU ACIS aes OL 14 B YG E eee rer ee terrae mene mnt reel eer iii 15 Grids directory and MS as 16 AN A sales gran suceeded bw awaeueenomotomwabaeah en eink 16 Porna place st dba 17 SAUS E E E eae lens ataaenmamadiantsora ae 17 Coordinates Grd sssi AAA AAA DAA AAA AA 19 Introduction Mapgen has its roots in osmdiff pl and osmrender pl They were very basic render programs Once Haiti was hit by the strong earthquake I wanted to provide large png maps for the local help This proved to be hard since so many things couldn t be done with my programs So I decided to improve the features of my renderer and give it a new name So the basic goals became e Fast and easy map generation different output formats e Fast extraction of needed data out of osm files place e Easy style file handling e Street and place directories Keep it simple easy invocation with only 2 mandatory parameters e Keep it pow
4. berg 8 4574995 50 38 qn 0 Parkplatz Feldbergha Using area icons Ways with borders Burg Apotheke Routes l ae _ Name Values Description l RouteType bus hiking see wiki gt Colo All valid colors A set of colors can be given by using the as a delimiter 3 Thickness INTEGER of the line 4 DashType See above Of the line 5 Opacity 0 100 Opacity in percent 6 Label Valid keys Key to get the label from 7 StopNodel INTEGER hickness 8 FromScale INTEGER ToScale INTEGER The colors will be assigned to each found route in order of occurrence in style file if no k v for the colors are present in the osm file Additionally the labels can be configured by command line parameters routelabelcolor TEXT color for labels of routes routelabelsize INTEGER DEFAULT 8 routelabelfont TEXT DEFAULT sans serif routelabeloffset INTEGER DEFAULT 10 A Bus routes in Frankfurt Some bus stops in Frankfurt Route icons Aditionally icons for routes can be added to the map if icons are provided as follows Create folder routeicons and save icons there As the file name choose the ref or the name of the route preceeded by the route type and a dash If the route has a ref the ref has to be used Example routeicons hiking E3 png OR routeicons hiking E3 svg The default icon directory can be changed icondir TEXT dir for icons f
5. black Optionally a scale value can be calculated and added to the map Of course the color for this text can be Set scale print scale scalecolor TEXT set scale color DEFAULT black A specific scale can be set 1 e 1 25 000 by adding scaleset 25000 to the command line To be able to work with this information you have to specify the resolution of the output device in dpi By default this is set to 300dpi scaleset INTEGER 1 x preset for map scale overrides size INTEGER set correct printer options scaledpi INTEGER print resolution DEFAULT 300 dpi Setting the scale overrides the size parameter The program will in any case print information on how big the map will be and on what paper size it will fit Setting a scale for rules alone If you specify a certain scale for rulescaleset then for selecting rules not the actual scale of the map is used but the specified one This 1s useful to show more or less details than initially intended by the given ruleset minScale maxScale A similar function can be found in the Garmin GPS receivers Map details normal more most less least rulescaleset INTEGER determines the scale used to select rules DEFAULI 0 meaning actual map scale is used to select rules Style file format In any case only one rule per object is used And this is the first matching rule according to the style file So 1t s possible 1 e first to look after all tracktype X Y and then havi
6. erful by using more parameters Hints The projection method used is not appropriate for very big areas Be aware that at the edges of the map items may be missing This may occur when items are not completely contained in the osm file You can try to prevent this by using the clip parameter with larger values Installation Put the mapgen pl file in a folder Put pm files in a subfolder called OSM can also be put into a directory contained in the INC pathes Get Math Poygon from CPAN and create a subfolder Math can also be put into a directory contained in the INC pathes e Install osmosis if desired take care that it can be invoked from command line Install inkscape if desired take care that it can be invoked from command line This is necessary when usein SVG files as tile patterns or when converting from SVG to PNG or PDF bzip2 installation sudo apt get install libcompress bz1p2 perl eGD installation sudo apt get install libed graph3d perl Information about Osmosis can be found here http wiki openstreetmap org wiki Osmosis Basic parameters Obviously there are some things that cant be hidden from the user So the user has to specify at least 2 basic parameters in file osm style style csv original can be kept and maintained in OO sheet or MS Excel in also supports osm bz2 format Default output name is mapgen svg Output Basic and only output format from mapgen itself is SVG That
7. has the advantage that all further formats contain all elements that mapgen can produce Disadvantage 1s a post processing done by inkscape out file svg png and pdf names are automatic DEFAULT mapgen svg There are two options specifying additional output formats png also produce png inkscape must be installed very big pdf also produce pdf inkscape must be installed The names are automatic and derived from the out name Inkscape must be installed and your system must be able to run it from command line in the current directory The PNG files are rather big So maybe some post processing is appropriate Usage examples Most simple form perl mapgen pl in file osm style mapgenRules csv Also specify an output name if you wish perl mapgen pl in file osm style mapgenRules csv out map svg Also specify size and that you want a PDF additionally perl mapgen pl in file osm style mapgenRules csv size 2048 pdf Now let s say you have a big osm file but only want a map of a certain city perl mapgen pl in germany osm style mapgenRules csv place Frankfurt This will probably not cover the whole of Frankfurt because the default radiuses are too small 2km each direction perl mapgen pl in germany osm style mapgenRules csv place Frankfurt lonrad 10 latrad 10 Now we want our map with grid lines and a street directory perl mapgen pl in file osm style mapgenRules csv grid 8 dir And let s turn off
8. ify the grid color The grid squares are labeled numerically and alphabetically grid lt integer gt number parts for grid O no grid DEFAULT 0 gridcolor TEXT color for grid lines and labels DEFAULT black E Ah A FIL Krankenhays of Street directory mapgen can even create a street directory It will do so including the grid squares where the street is located if the grid is turned on Output is an unformatted street list to be further processed The grid squares are separated by a tab File name is name_streets txt dir create street directory in separate file if grid is enabled grid squares will be added In the next table you can see a section of the street directory On the left without grids on the right with grid squares Burgstrake BULO TE 624 5 ee oe oe eee a ee BL Cohausenstrabfe Cone usensttabe o ess Al A2 Bl Crufterostrafe CFUTTEPOS ELA 4 y aa D2 Elisabethenstra e EHlisabethenstrab a Bz Cl C2 D1 El Eschborner Weg ESechpbocner WEG 6 ace Sawa e die ee Cl Feldbergstrake Feldbergstrabes 14 425464 i5e0 es Al Bl Poi and place list You can print a poi and place list like the street directory Grid option applies as well poi create list of pois PC ee te a6 a Ce le ae Bale a Stade ES Diedenbergen ss sc ecese F4 Ha heL Mereu au a e tee G5 Edeka Kundenparkplatz G7 Falkenberg Keramag E7 Bed eS SIM dra F6 GeldaltoMali nd eal Statistics You can p
9. ng a default rule for all highway track So it is important to have more specific rule higher above in the sheet file The different sections of the file start with a SECTION line This line contains the word SECTION in the first cell These lines are mandatory even if no rules for a section are present You can add COMMENT lines for remarks 1f you enter COMMENT in the first cell These lines will be omitted when style file is read File Note that you can enter multiple key value pairs for a rule Valid for nodes and ways Different entries must be separated by a I If you for example want a rule for all tracks with tracktype grade1l then the entries would be column key tag highway tracktype column value track gradel Nodes Column Dor y Name Values Description see wiki l key 66199 values can be separated by a I see above see wiki 2 value an asterisk may be used as a wild card values can be separated by a I see above 3 color see separate table the fill color thickness INTEGER key where value will be the label text entries can 5 label be separated by or AND PRIO special keys _lon and _lat 6 label color see list below label size INTEGER size of text label offset in y direction for offset A multiple labels per node 9 legend 0 or
10. or routes icondir i e DEFAULT routeicons You can also change the default distance of 25 pixels between multiple icons for same way routeicondist INTEGER dist in y direction for route icons on same route DEFAULT 25 Colors aliceblue antiquewhite aqua aquamarine azure beige bisque black blanchedalmond blue blueviolet brown burlywood cadetblue chartreuse chocolate coral cornflowerblue cornsilk crimson cyan darkblue darkcyan darkgoldenrod darkgray darkgreen darkgrey darkkhaki darkmagenta darkolivegreen darkorange darkorchid darkred darksalmon darkseagreen darkslateblue darkslategray darkslategrey darkturquoise darkviolet deeppink deepskyblue Pru dimgray dimgrey dodgerblue firebrick floralwhite forestgreen fuchsia gainsboro ghostwhite gold goldenrod gray green greenyellow grey honeydew hotpink indianred indigo ivory khaki nhildisstein 8 4308 50 23 3 u lavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyan lightgoldenrodyellow lightgray lightgreen lightgrey lightpink lightsalmon lightseagreen lightskyblue lightslategray lightslategrey lightsteelblue lightyellow lime limegreen linen magenta maroon mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen mediumslateblue mediumspringgreen mediumturquoise mediumvioletred midnightblue mintcream mistyrose moccasin Fonts serif esans se
11. pgen will register an used area for each drawn label except street labels and won t use this area again emapgen will register an used area for each drawn icon and won t use this area again Icons will be placed at the given location Text labels for nodes and areas will be placed on a default position and orientation If this is not possible other positions and alignments will be tried So labels might me moved and or omitted at all At the end of map drawing program will show how many labels and icons were omitted or moved To prevent a special form of clutter caused by certain parallel ways the following option may be specified declutter declutter text WARNING some labels might be omitted motorway and trunk will only be labeled in one direction eMotorways and trunks will be labeld only in one direction mapgen tries not to put labels on ways that are too short To do so it calculates the length of the way and the length of the text This 1s done by assuming a need of 6 pixels per character for a 10pt font Other font sizes are calculated automatically If you find out that 6 ppc doesn t suit your used font please reconfigure the value using the following option ppc lt float gt pixels needed per label char using font size 10 DEFAULT 5 5 Grids directory and stats A grid can be laid over the map Just specify the number of squares you want in longitude direction The other dimension 1s automatic Of course you can spec
12. rif ecursive efantasy monospace Times Baskerville e Verdena eSymbol Oneways navajowhite navy oldlace olive olivedrab orange orangered orchid palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuff peru pink oneways add oneway arrows onewaycolor TEXT plum powderblue purple red rosybrown royalblue saddlebrown salmon sandybrown seagreen seashell sienna silver skyblue slateblue slategray color for oneway arrows slategrey snow springgreen steelblue tan teal thistle tomato turquoise violet wheat white whitesmoke yellow yellowgreen Extracts If you don t wan t the whole osm data to be printed that is contained in the file no problem As long as you have installed osmosis and this can be invoked from the current directory by command line Just specify the name of a place and mapgen will look for such a place Upon success 1t will invoke osmosis to extract the needed data By default a width and height of 4km 2 2km radius is set But of course it can be overridden place TEXT Place to draw automatically quotation marks can be used if necessary OSMOSIS REQUIRED lonrad FLOAT radius for place width in km DEFAULT 2 latrad FLOAT radius for place width in km DEFAULT 2 Program will print used OSMOSIS string to STDOUT for later use Declutter Usually when drawing maps especially with lots of details clutter may occur ema
13. rint a tag statistic about the usage of the keys and values To keep the list short unimportant keys are omitted This must be adapted in the code if desired The idea is to see what keys are used mostly So you can decide for which features rules are needed Mapgen will print an alphabetical list of keys and values as well as a list of the most used k v combinations At the end of each line the program prints if it knows a rule for that k v Output is separated for nodes and ways and will be written in a file called name_tagstat txt tagstat lists keys and values used in osm file short see code array noListTags TOR 20 TESTS highway highway oneway highway highway highway TOGE highway oreko kialo bicycle amenity surface service highway landuse highway highway highway amenity amenity residential footway yes service primary steps yes secondary yes yes parking cobblestone parking_aisle pedestrian residential track path living_street restaurant pharmacy TAS hebra ay WOCDOOFRNAWOFRAE OI O1 O1 UO1 OY O CO program filters list to keep them RULE RULE RULE RULE RULE RULE RULE RUER RULE RULE Obviously we should maybe implement a rule for oneway yes And we can see that by far the most used tag here is highway residential Coordinates Grid You can add a grid of coordinates to your map by specifying the coords option By default the grid distance is 0 01 degrees
14. the legend perl mapgen pl in file osm style mapgenRules csv legend 0 Map size and the like The background color can be set according to the given color set The size of the picture 1s specified by the width in pixels Height is automatically calculated Clipping means that not all of the data given in the osm file will be presented This 1s useful to clip incomplete data at the edges of the area in the osm file Program will output some useful information about map and paper sizes as well as resolution and scale bgcolor IEXT color for background size lt integer gt in pixels for x axis DEFAULT 1024 clip lt integer gt percent data to be clipped on each side O no clipping DEFAULT 0 Advanced parameters By default a legend is drawn in the upper left corner This can be switched off legend INT O no legend l1 legend DEFAULT 1 The legend will only show elements that would be drawn if present in the current map scale A ruler is drawn by default in the upper right corner This can be switched off as well Additionally a Po it tower F Y Krankenhays Hofpeiry 3 residential MOtorway primary secondary tertiary track A O Ex footway of Set en PI A path Ad 7 7 cycleway line rail park forest farmland rt Pees Ped gt rs color can be specified ruler INT O no ruler l draw ruler DEFAULT 1 rulercolor TEXT DEFAULT
Download Pdf Manuals
Related Search