AND Data/Spec-pure text version

From OpenStreetMap Wiki
Jump to: navigation, search

Navigation Shape format description v1.2

_________________________________________________________

Copyright Notice

The copyright on all AND Street Maps (including but not limited to any images, photographs, animations, video, audio, music, text and "applets" incorporated into the product), copies of the product and the accompanying printed materials, are and at all times remain the ownership of AND Products B.V. All modifications, data enhancements, revisions or any other changes made to the product shall be deemed to be the sole and exclusive property of AND Products B.V. This product may only be used for purposes specifically authorized within your contract with AND Products B.V. All rights to the product not expressly granted in writing to user are reserved to AND Products B.V. Copyright laws and international copyright treaties, as well as other intellectual property laws and treaties, protect this product. You may not remove the copyright notice from any copy or part of the product. 'AND' as used throughout this document represents AND Products B.V., AND International Publishers N.V. or AND Automotive Navigation Data.

Copyright 2006-2007 AND International Publishers N.V. License OpenStreetMap by AND Automotive Navigation Data OpenStreetMap is allowed to import the Navigation Shape format description in the OpenStreetMap Wiki and import the digital maps in the OpenStreetMap. This document and the digital map may be edited by the OpenStreetMap community under the Creative Commons-Attribution-ShareAlike 2.0 license.

Disclaimer Notice AND is not liable for any damages (including, without limitation, incidental, direct, indirect special and consequential damages, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use or inability to use this product or its information. AND' as used throughout this document represents AND Products B.V., AND International Publishers N.V. or AND Automotive Navigation Data.

AND Automotive Navigation Data

AND Automotive Navigation Data is leading provider of digital mapping data used for location-based services around the world. AND Automotive Navigation Data focuses on the development of digital maps in Central and Eastern Europe, North-Africa, Central and South America and Australia. The digital maps are used in personal and `in-car' navigation, Internet-based mapping, fleet management and more. The company employs approximately 250 employees. The company was founded in 1984, is headquartered in Rotterdam, the Netherlands and is listed on Euronext Amsterdam (AND). AND is found on the internet via www.and.com.


 Revision history 
      
 Date          Version      Remarks 
 23-Dec-05     v1.0          
 *  Added functional road class Fc# in RD_OTHER field in Roads file 
 *  Added long haul Lh# in RD_OTHER field in Roads file 
 *  Added stub Links Stub# in RD_OTHER field in Roads file 
 *  Added house number ranges Hn# in RD_OTHER field in Roads file 
 *  Code page support Per country, a code page in Navigation Shape *.dbf files 
 *  Added synonyms ­ exonyms Creation of Alias table 
 *  Added administrative boundaries Per country administrative boundaries are delivered 
 *  Added signpost information Creation of Signpost table 
 *  Added land use polygons Following land use polygons are added: 
  -  Beach, dune and plain sand 
  -  Built-up area 
  -  Cemetery 
  -  Forest, Woodland 
  -  Golf course 
  -  Industrial area 
  -  Moors and heath land 
  -  Park, garden 
 
 17-Jan-06     v1.1         Added types of boundary files 
 Updating of field ND_TYPE (boundary files) 
 23-Feb-06     v1.2         Updated roads file 
 Updating of field RD_FLOOR 
 Updating of field RD_LEVEL 

Locations file

 Field    AND descriptive name  Format      ID        Description 
 
 ND_1     ND_ID                   N8                  Internal AND-ID 
 ND_2                             N2        0         Used for compatibility with AND format, always `0' 
 ND_3                             N2        0         Used for compatibility with AND format, always `0' 
 ND_4     ND_TYPE                 N3                  Node type 
                                            0         Standard node 
                                            1         Junction (exit) 
                                            2         Intersection 
                                            3         Border node 
                                            4         Directional information 
                                            5         Toll Booth Info 
                                            9         Level dead end, location other than a type 3 or 10-27 where a level may terminate 
                                            10        Capital City 
                                            11        Large city > 500,000 
                                            12        Medium city > 100,000 
                                            13        Small city > 50,000 
                                            14        Town > 20,000 
                                            15        Village > 5,000 
                                            16        Small village > 1,000 
                                            17        Tiny village < 1,000 
                                            19        Postal code point 
                                            20        Postal code area 
                                            21        Numbered town district (e.g. Dublin 4) 
                                            22        Town district > 100,000 
                                            23        Town district > 50,000 
                                            24        Town district > 20,000 
                                            25        Town district > 5,000 
                                            26        Town district > 1,000 
                                            27        Town district < 1,000 
                                                      A town or village is upgraded (one or two types) if it is a national or regional centre. 
                                                      A village of type 17 is upgraded to type 16 if it has an own postal code. 
                                                      A village (type 16 or 17) is upgraded (one type) if it is important from a tourist point of view. 
                                            30        Railway station 
                                            36        Car/train terminal 
                                            40        Airport; no information available 
                                            41        Big international airport (>10,000 flights per year) 
                                            42        Medium international airport (400-10,000 flights per year) 
                                            43        Small international airport (<400 flights per year) 
                                            44        Heliport 
                                            45        Seaplane Base 
                                            46        Big national airport (>10,000 flights per year) 
                                            47        Medium national airport (400 - 10,000 flights per year) 
                                            48        Small national airport (<400 flights per year) 
                                            80        Rest area with at least parking and petrol station.  
                                            81        Rest area with parking only 
                                            82        Rest area with only parking and petrol station 
                                            83        Rest area with parking, petrol station and restaurant 
                                            84        Rest area with parking, petrol station, restaurant and hotel 
                                            85        Rest area with parking, restaurant and hotel 
 ND_5      ND_NATION                 N3               Nation code (table is available _c.lst file) 
 ND_6      ND_LEVEL                  N2               Connection level. The connection level of a node equals the level of the road on which it is situated (see Roads file) 
 ND_7      ND_DELETED                L                For backward compatibility (0) 
 ND_8      ND_ZIP                    C10              Postal code 
 ND_9      ND_NAME                   C60              Name 
 ND_10     ND_NAME_PREFIX            C10              Name prefix, e.g. "la" 
 ND_11     ND_NAME_SUFFIX            C20              Name suffix, e.g. "bei Wien" or "plage" 
 ND_12     ND_NAME_COMP              C2               Compass direction (N, S, E, W, NE etc.) of ND_NAME 
 ND_13     ND_CODE                   C10              Official code belonging to ND_NAME. Exit number Community code IATA airport code Etc. 
 ND_14     ND_PROV                   N3               Province code (table is available _p.lst file) 
 ND_15     ND_UN_PROV                L                Flag if province code is needed for unique making of ND_NAME 
 ND_16     ND_UN_CITY                C60              City name for unique making of ND_NAME 
 ND_17     ND_UN_CITY_PREFIX         C10              Prefix for ND_UN_CITY 
 ND_18     ND_UN_CITY_SUFFIX         C20              Suffix for ND_UN_CITY 
 ND_19     ND_UN_CITY_PROV           N3               Province code for unique making of  ND_UN_CITY 
 ND_20     ND_UN_CITY_COMP           C2               Compass direction relative to ND_UN_CITY for unique making of ND_NAME 
 ND_21     ND_CONURB                 C60              Name of conurbation to which suburb or town district belongs 
 ND_22     ND_CONURB_PREFIX          C10              Prefix for ND_CONURB 
 ND_23     ND_CONURB_SUFFIX          C20              Suffix for ND_CONURB 
 ND_24     ND_CONURB_UN_PROV         N3               Province code for unique making of ND_CONURB 
 ND_25     ND_ID_PERMANENT           N10              Permanent node ID, internal AND 
 ND_26     ND_DBLINK                 C60              Field for client specific ID or ID's, e.g. ESRI = 123456 
 ND_27     ND_KM                     C30              Kilometres / Mileage 
 ND_28     ND_TMC                    C60              TMC-code 
 ND_29     ND_OTHER                  C60              For internal use

Roads file

 Field     AND descriptive name     Format  ID          Description 
 RD_1      RD_ID                    N8                  ID of roads 
 RD_2                               N2      0           Used for compatibility with AND format, always `0' 
 RD_3      RD_LENGTH                N5                  Road length in hectometers 
 RD_4      RD_DIRECTION             N1                  Permitted Traffic Flow 
                                            0           Traffic allowed in both directions 
                                            1           Traffic allowed from RD_ID_FROM to 
 RD_ID_TO 					       
                                            2           Traffic allowed from RD_ID_TO to  
 RD_ID_FROM 					       
 RD_5      RD_TYPE                  N2                  Road classification 
                                            1           Motor way 
                                            2           Federal highway dual carriage way (motor way characteristics) 
                                            3           Federal highway 
                                            4           Regional road 
                                            5           Local road 
                                            6           Other road 
                                            7           Ferry (cars and cargo) 
                                            9           Train ferry (passenger and/or cargo) 
                                            30          Railway, passenger and/or freight transport 
                                            50          Link to airports, railway stations 
                                            58          Walking connection between Railway stations 
                                            59          Virtual connection. Used to connect features in the data that are not linked by any other defined features in the database 
 RD_6      RD_NATION                N3                  Nation code (table is available _c.lst file) 
 RD_7      RD_LEVEL                 N2                  Connection level. The connection level of a road expresses the importance of that road. The general classification is as 
 follows: 					       
                                            0           E-roads in Europe 
                                            1           Important national roads in such a way that all type 10 to 13 locations are connected. Scale   1 : 4,000,000 
                                            2           Secondary roads in such a way that all type 10 to 14 locations are connected. Scale   1 : 2,000,000   
                                            3           Through roads in such a way that all type 10 to 15 locations are connected. Scale   1 : 1,000,000 
                                            4           Local connector roads in such a way that all type 10 to 16 and 20 to 26 locations are connected.  Scale   1 : 500,000                                                                                                                            
                                            5           Other roads Scale   1 : 250,000 
                                            6           All other roads (streets) 
                                            10          All railways 
 RD_8      RD_DELETED               L                   AND Internal Code 
 RD_9      RD_SLOW                  C1      C           Slow road type (road within city limits) 
 RD_10     RD_NAME                  C60                 Road (street) name 
 RD_11     RD_CODE_NAT1             C12                 National road number 
 RD_12     RD_CODE_NAT2             C12                 National road number 
 RD_13     RD_CODE_NAT3             C12                 National road number 
 RD_14     RD_CODE_INT1             C12                 International road number 
 RD_15     RD_CODE_INT2             C12                 International road number 
 RD_16     RD_CODE_INT3             C12                 International road number 
 RD_17     RD_TUNNEL                L                   Tunnel flag 
 RD_18     RD_TOLL                  L                   Toll flag 
 RD_19     RD_TIME                  N5                  Ferry journey time in minutes 
 RD_20     RD_FLOOR                 N1                  Relative height to a crossing feature 1 is below 2 is below 3 etc. 9 if relative height is unknown. 
 RD_21     RD_TONNAGE               N3                  Tonnage admitted on ferry 
                                            -1          Only passengers (ferries) ­ Also used for pedestrian streets/ virtual connections 
                                            3           max. 3.5 metric tons 
                                            28          max. 28 metric tons 
                                            40          max. 40 metric tons 
                                            99          > 100 tons 
 RD_22      RD_TOLL_CARGO           L                   Toll (for trucks only) flag 
 RD_23      RD_OTHER                C60                 Other Attributes: 
                                            Sr#1        Slip road segment 
                                            Rb#1        Roundabout segment 
                                            Lb#1        Lay-by segment 
                                            4wd#1       Four wheel drive road segment 
                                            Unsealed#1  Unsealed road segments 
                                            Fc#[0-4]    Functional road class 0 to 4 
                                            Lh#1        Long haul 
                                            Stub#1      Stub link 
                                            hn#         Housenumber range 
                                                        L : left, direction from FNODE_  
                                                        to TNODE_  
                                                        R: right, direction from FNODE_  
                                                        to TNODE_  
                                                        E: even 
                                                        O: odd 
                                                        M: mixed 
                                                        e.g. hn#LE2-12#RO1-11 
 RD_24      RD_PROV                 N3                  Province code (table is available _p.lst file) 
 RD_25      RD_CITY_ID              N11                 City code of link (link to ND_ID) 
 RD_26      RD_MUN_ID               N11                 Municipality code of link (table is available _m.dbf file) 
 FNODE_     FNODE_                  N12                 From node ID of link  
 TNODE_     TNODE_                  N12                 To node ID of link

Maneuvers and Path index file (TUR, PTH)

Maneuvers file *.TUR

 No    Field           Format             Values               Description 
 
 1     ID              N8                                      Maneuver ID 
 2     TYPE            C60                Prohibited maneuver  Prohibited maneuver only. 
                                          Priority maneuver 
                                          Bifurcation 
 3     BIFTYPE         C60                Undefined            Classification of the bifurcation type maneuver. 
                                          Multi lane fork 
                                          Simple fork 
                                          Exit bifurcation 
                                          
  
 

Path index file *.PTH

 No  Field             Format             Values               Description 
 
 1     ID              N8                                      Maneuver ID 
 2     SEQNR           N1                                      Sequence number 
 3     TRPELID         N8                                      Road element ID / Node ID, derived from Fnode_ or Tnode_ (refers to roads file : AND_ID of link). 
 
 

Signpost index table and signpost file (SIT, SIP)

Signpost Index Table file *.SIT

 No  Field            Format  Values  Description 
                      
 1   ID               N8              Signpost ID 
 2   SEQNR            N1              Sequence Number 
 3   TREL ID          N8              Roads ID (refers to Roads file: RD_ID) 
 4   TREL TYPE        C60     Road    Type (Road) 
 
 

Signpost Table file *.SIP

 No  Field            Format  Values  Description 
 
 1   ID               N8              Signpost ID 
 2   JUNCTION ID      N8              Road Node ID (derived from Fnode_ or Tnode_) 
 3   SEQNR1           N1              Sequence Number 
 4   SEQNR2           N1              Sequence Number 
 5   INFO TYPE        C60             Information type 
 6   TEXT             C60             Place name/Exit name 
 7   TEXT LANG        C3              MARC Language code 
 8   CON TYPE         N1      0       Undefined 
                              1       Branch 
                              2       Towards 
                              3       Exit 
 

boundary files

 Field  AND descriptive name   Format  ID    Description 
 ND_1   ND_ID                  N8            Internal AND Link ID 
 ND_4   ND_TYPE                N3            Region type 
                                       90    Land 
                                       91    Inner seas and huge lakes with major geographical referential impact 
                                       92    Very big river/lake and/or country separating river/lake 
                                       94    Province/department separating river/lake 
                                       95    Capital or Metropolis 
                                       96    Forest, Woodland 
                                       97    Other river/lake 
                                       98    Other city cities having population more than 5000 
                                       99    Airports (National and International) 
                                       100   Ocean, sea  
                                       101   City park, garden 
                                       102   Regional, national park 
                                       103   Small cities having population less than 5000 
                                       104   Cemeteries 
                                       105   Golf course 
                                       106   Beach, dune 
                                       107   Plain sand 
                                       108   Moors, heath land 
                                       109   Industrial area 
 ND_5   ND_NATION              N3            Nation code (table is available) 
 ND_9   ND_NAME                C60           Name 
 ND_14  ND_PROVINCE            N3            Province code (table is available). 
 


 Following administrative boundaries are delivered: 
 
 <file name>_admin0.*       Highest delivered administrative division. Equal to order 0 in GDF3.0 specification (country). 
 <file name>_admin8.*       Lowest delivered administrative division. Equal to order 8 in GDF3.0 specification. 
 <file name>_admin[1..7].*  Intermediate administrative division.  
 
 Landuse boundaries: 
 <file name>_a.*            Airports (National and International) 
 <file name>_b.*            Beach, dune and plain sand 
 <file name>_c.*            City, built-up area 
 <file name>_ce.*           Cemetery 
 <file name>_f.*            Forest, woodland 
 <file name>_gf.*           Golf course 
 <file name>_h.*            Moors and heath land 
 <file name>_i.*            Island 
 <file name>_in.*           Industrial area 
 <file name>_o.*            Ocean/sea 
 <file name>_pk.*           Park, garden 
 <file name>_w.*            Water boundaries
   <file name>_w_maj.*      or Major water boundaries 
   <file name>_w_min.*      or Minor water boundaries

Administrative division files

The level of the administrative division can vary from country to country but it is referred to as the province boundary layer in all cases, and is the most detailed level of administrative division supplied for each country.


Administrative divisions format

 Associated with the province boundary layer, there are 4 comma-separated `*.lst' files: 
 *  *_p.lst       (Province) 
 *  *_r.lst       (Region) 
 *  *_s.lst       (State) 
 *  *_c.lst       (Country) 


Administrative divisions in the data

The number of hierarchical divisions that occur is country-specific. All countries receive the lowest or most detailed administrative division - i.e. the Province'.

The term `Province' is used here and refers to the most detailed level of administrative division represented by AND within a country. Due to the large variation in use of this term between countries, it does not always indicate actual provinces as described within a country in its administrative hierarchy. The same is true for the terms `Region' and `State'.

Currently, a maximum of 3 administrative levels (below country level) exists in AND's Global Road Data. For the purpose of this document the most detailed level will be described as the `Province', the level above this as the `Region' and the one above this as the `State' division.

 --------------------------------------------
 |                      |                   |
 |                    Nation                |
 |                      |                   |
 -------State--------------------------------
 |        |             |                   |
 |        |             |                   |
 |      Region          |                   |
 |        |             |                   |
 |        |  Province   |                   |
 |        |             |                   |
 --------------------------------------------
 

Figure 1: "Administrative Division Hierarchy in AND Data"


The provision of province, region, state and country information in the AND data varies between and within datasets as the following table illustrates:


 Continent               Province  Information   Region Information   State Information  Country Information 
 
 Europe                  eur_p.lst              eur_r.lst          eur_s.lst          eur_c.lst 
 North America           nam_p.lst              nam_r.lst          Not applicable     nam_c.lst 
 Central/South America   sam_p.lst              sam_r.lst          Not applicable     sam_c.lst 
 Australasia             as_p.lst               as_r.lst           Not applicable     as_c.lst 
 Africa                  af_p.lst               af_r.lst           Not applicable     af_c.lst 
 North Pole              Not applicable         Not applicable     Not applicable     np_c.lst 
 
 

All `*.lst' files, except _c.lst, have a corresponding `*.num' file that give a total count of the administrative divisions per country.

The format of the `*.num' files is as follows:


 Field  Field name         Description 
 
 1      Country number     Same number as in *_c.lst 
 2      Division count     Total number of administrative divisions 
 3      Division name      Official administrative naming 


Description of the *.lst files

Administrative boundary information in AND data is supplied as a graphical province boundary file and one or more accompanying `*.lst' files. The following tables describe the field structure of the `*.lst' files at each administrative level:


 Field  Province information 
 
 1      Nation code 
 2      Province code (AND assigned) 
 3      Province Abbreviation/code (Official) 
 4      Province Name 
 5      Official number (Germany only) 
 6      Region code 
 7      State code 
 
 
 Field  Region information 
 1      Nation code 
 2      Region code (AND assigned) 
 3      Region Abbreviation/code (Official) 
 4      Region Name 
 
 Field  State information 
 1      Nation code 
 2      State code (AND assigned) 
 3      State Abbreviation/code (Official) 
 4      State Name 
 
 Field  Country Information 
 1      Nation code 
 2      Nation Abbreviation/code (Official) 
 3      Nation Name 
 

Apart from the <dataset>_c.lst file at country level, the province or `<dataset>_p.lst' file is the only file that can be directly associated with the graphical province boundaries. The boundaries contain a province code attribute ­ a six digit figure comprising the nation code (first 3 digits) and province code (last three digits) combined. This can be used to match the boundaries to their corresponding entry in the <dataset>_p.lst file.

Example : Europe_p.lst

 Image innertext to be converted to a the corresponing figure: 
 "....`044003' province code will appear in the AND province boundary data (graphical). 
 The nation code field and the province code field combined from the <dataset>_p.lst file form  
 the unique identifier for all province boundaries in the AND boundary data. 
 ...AND Province Boundary Data  (Graphical) ...<dataset>_p.lst
 ...NATION CODE...
 PROVINCE CODE
 ..."044003"
 ..."044004"
 ..."
  

Figure 2: Link between graphical province boundaries and <dataset>_p.lst file

The <dataset>_r.lst file and <dataset>_s.lst file are not directly linked with the graphical data. Instead they provide extra information on the region or state in which each province resides. The associated region and state for each province is identified in a `region code' and `state code' field in the <dataset>_p.lst file. The process by which region or state information can be retrieved and linked to the graphical data is described in the next section.

Linking and mapping all administrative data

The country or <dataset>_c.lst file can be linked to all other *.lst files as follows:

 Figure 3 to be placed here!!!!
  

Figure 3: Linking the <dataset>_c.lst file with other *.lst files


This allows the nation abbreviation and name to be linked to all levels of administrative division. Because the AND province boundary data is only directly linked to the <dataset>_c.lst and <dataset>_p.lst files, it is necessary for links to exist between the <dataset>_p.lst file, the <dataset>_r.lst and <dataset>_s.lst. This allows all information in all *.lst files to be mapped to the province boundaries. The links are as follows:

 Figure 4 to be placed here!!!!
  

Figure 4: Linking the <dataset>_p.lst file with other* .lst files

Example of administrative division mapping

The following example shows how these links can be used to map all administrative information to the province boundary layer.

In Switzerland, there are 2 hierarchical administrative divisions (below Country) ­ province and region. There is the AND province boundary data, a <dataset>_p.lst file, a <dataset>_r.lst file and a <dataset>_c.lst file.


 Figure 5a to be placed here!!!!
  

Figure 5a: Graphical Representation of Province Boundaries in AND GRD


Each province in the AND province boundary data has a 6 digit code. This can be used to link information from the <dataset>_p.lst file. Once this record has been identified, further information in the `region code' and `state code' fields can be used to link the <dataset>_r.lst file and <dataset>_s.lst file to the map.

 Figure 5b to be placed here!!!!
  

Figure 5b: eur_p.lst file

 Figure 5c to be placed here!!!!
  

Figure 5c: eur_r.lst file

 Figure 5d to be placed here!!!!
  

Figure 5d: eur_c.lst file

Mapping Administrative Information using *.lst file links

Using the links between the *.lst file, the province boundaries can then display the following information:


 Figure 6 to be placed here!!!!
 

"Ticino ... Tessin ... Switzerland"

Figure 6: AND Province Boundary display with associated administrative division information

Alias format file

 The purpose of the alias file is to provide alternative names for named nodes addressable on the administrative 
 level (e.g. cities). 
 
 The names are stored in a *.csv format using the following structure: 
 
 
 Field  Field name       Description 
 
 1      Xlong            Longitude in decimal degrees 
 2      Ylat             Latitude in decimal degrees 
 3      Mode             Always `V' corresponding to "alias name" 
 4      Lang1-Lang2      The language codes refer to the USMARC Code list for languages 
 5      Name1            Official language name 
 6      Name2            Alternative name