User's manual NAVIGON Integration Kit 4.0 as on October 2004 Impressum NAVIGON GmbH Berliner Platz 11 D-97080 Würzburg Hotline (dtms-Service, 0,12 /min): +49 180-5-NAVIGON (+49 180-5-6284466) The information contained herein may be changed at any time without prior notification. This manual nor any parts thereof may not be reproduced for any purpose whatsoever without the express written consent of NAVIGON GmbH, nor transmitted in any form either electronically or mechanically, including photocopying and recording. Copyright 2004, NAVIGON GmbH All rights reserved. User's manual NAVIGON Integration Kit 4.0 Table of contents 1 Introduction................................................................6 1.1 1.2 1.3 1.4 On this manual................................................................. 7 Specification of services .................................................... 7 1.2.1 Supported operating systems .................................. 8 System requirements ........................................................ 9 Installation ...................................................................... 9 1.4.1 Installation of the Windows 2000/XP version ............10 1.4.2 Installation of the Windows CE version ....................10 Search facilities and conventions .......................................11 Liability ..........................................................................11 1.6.1 Support ...............................................................12 Trademarks ....................................................................12 1.5 1.6 1.7 2 Programming interfaces............................................ 13 2.1 Requirements for using NIK with a development environment 14 2.1.1 Using the interfaces ..............................................14 2.1.2 A survey on the interfaces .....................................15 IMNNIK ..........................................................................15 2.2.1 MNOpen() method ................................................16 2.2.2 MNClose() method ................................................16 2.2.3 GetMNOpen() method ...........................................17 2.2.4 GetMNVersion() method ........................................17 2.2.5 Starting and closing NIK ........................................18 IADDRESS ......................................................................19 2.3.1 OpenAddress() method) ........................................20 2.3.2 CloseAdress() method ...........................................20 2.3.3 SearchFirstCityAddress() method ............................21 2.3.4 SearchFirstCityPostalCodeAddress() method ............22 2.3.5 SearchNextCityAddress() method ...........................23 2.3.6 SearchFirstStreetAddress() method.........................25 2.3.7 SearchNextStreetAddress() method ........................27 2.3.8 SearchPoiByRadiusAddress() method ......................28 2.3.9 SearchNextPoiAddress() method .............................30 2.3.10 ConvertCoordInAddress() method .........................31 2.3.11 ConvertCoordInAddress2() method .......................32 2.3.12 ConvertCoordInCountry() method .........................33 IROUTING ......................................................................34 2.4.1 OpenRoute() method.............................................35 2.4.2 CloseRoute() method ............................................36 2.4.3 AddDestCoordRoute() method ................................36 2.4.4 GetDestCoordRoute() method ................................37 2.4.5 ClearDestCoordRoute() method ..............................38 2.4.6 StartRoute() method .............................................38 2.4.7 ShowRoute() method ............................................39 2.4.8 ClearRoute() method.............................................39 2.4.9 ZoomInRoute() method .........................................40 2.4.10 ZoomOutRoute() method .....................................40 2.2 2.3 2.4 Table of contents -I- User's manual NAVIGON Integration Kit 4.0 2.4.11 2.4.12 2.4.13 2.4.14 2.4.15 2.4.16 2.4.17 2.4.18 2.4.19 2.4.20 2.4.21 2.4.22 2.4.23 2.4.24 2.4.25 2.4.26 2.4.27 2.4.28 2.4.29 2.4.30 2.5 ShowDownRoute() method...................................40 ShowUpRoute() method .......................................41 ShowLeftRoute() method .....................................41 ShowRightRoute() method ...................................41 ShowStartPointRoute() method.............................42 ShowEndPointRoute() method ..............................42 SetRotationRoute() method ..................................43 GetRotationRoute() method..................................43 GetStatusRoute() method ....................................44 GetResultRoute() method.....................................44 MapShowRoute() method .....................................45 GetFirstWayListRoute() method ............................45 GetNextWayListRoute() method ............................46 SetZoomLevelInRoute() method ...........................47 GetZoomLevelInRoute() method ...........................48 SetMaxResolutionRoute() method .........................48 GetMaxResolutionRoute() method .........................49 ChangeGeoToMapCoordRoute() method .................49 ChangeMapToGeoCoordRoute() method .................50 Example for route calculation................................51 IPOSITION......................................................................52 2.5.1 OpenPosition() method ..........................................53 2.5.2 ClosePosition() method..........................................54 2.5.3 StartPosition() method ..........................................54 2.5.4 GetPosition() method ............................................55 2.5.5 ZoomInPosition() method ......................................55 2.5.6 ZoomOutPosition() method ....................................56 2.5.7 ShowDownPosition() method..................................56 2.5.8 ShowUpPosition() method ......................................56 2.5.9 ShowLeftPosition() method ....................................57 2.5.10 ShowRightPosition() method.................................57 2.5.11 SetRotationPosition() method ...............................57 2.5.12 GetRotationPosition() method ...............................58 2.5.13 MapShowPosition() method ..................................59 2.5.14 SetBirdViewPosition() method...............................59 2.5.15 SetZoomLevelInPosition() method.........................60 2.5.16 GetZoomLevelInPosition() method ........................60 2.5.17 SetMaxResolutionPosition() method.......................61 2.5.18 GetMaxResolutionPosition() method ......................61 2.5.19 ChangeGeoToMapCoordPosition() method ..............62 2.5.20 ChangeMapToGeoCoordPosition() method ..............62 INAVIGATION .................................................................64 2.6.1 OpenNavigation() method ......................................66 2.6.2 CloseNavigation() method......................................67 2.6.3 SetDestIdNavigation() method ...............................67 2.6.4 GetDestIdNavigation() method ...............................68 2.6.5 SetDestCoordNavigation() method ..........................68 2.6.6 GetDestCoordNavigation() method..........................69 2.6.7 SetDestTrackNavigation() method...........................70 2.6.8 StartNavigation() method ......................................71 2.6.9 ShowRouteNavigation() method .............................71 2.6.10 RepeatLastAdviceNavigation() method ...................72 2.6.11 ZoomInNavigation() method.................................72 2.6.12 ZoomOutNavigation() method ..............................72 2.6.13 ShowDownNavigation() method ............................73 2.6.14 ShowUpNavigation() method ................................73 2.6.15 ShowLeftNavigation() method...............................73 2.6 - II - Table of contents User's manual NAVIGON Integration Kit 4.0 2.6.16 2.6.17 2.6.18 2.6.19 2.6.20 2.6.21 2.6.22 2.6.23 2.6.24 2.6.25 2.6.26 2.6.27 2.6.28 2.6.29 2.6.30 2.6.31 2.6.32 2.6.33 2.6.34 2.6.35 2.6.36 2.6.37 2.7 ShowRightNavigation() method.............................74 ShowStartPointNavigation() method ......................74 ShowEndPointNavigation() method........................74 SetRotationNavigation() method ...........................75 GetRotationNavigation() method ...........................75 GetStatusNavigation() method..............................76 GetRoutingResultNavigation() method ...................76 ShematicViewOpenNavigation() method.................77 ShematicViewShowNavigation() method ................78 DistanceBarOpenNavigation() method ...................79 DistanceBarShowNavigation() method ...................80 MapShowNavigation() method ..............................80 SetBirdViewNavigation() method...........................81 GetFirstWayListNavigation() method......................81 GetNextWayListNavigation() method .....................82 SetZoomLevelInNavigation() method.....................83 GetZoomLevelInNavigation() method ....................84 SetMaxResolutionNavigation() method...................84 GetMaxResolutionNavigation() method ..................85 ChangeGeoToMapCoordNavigation() method ..........85 ChangeMapToGeoCoordLocationMap() method........86 Examples ...........................................................87 IOPTIONS .......................................................................89 2.7.1 SetRoutingAlgorithmOptions() method ....................90 2.7.2 SetRoutingAlgorithmOptions2() method...................91 2.7.3 GetRoutingAlgorithmOptions() method ....................91 2.7.4 GetRoutingAlgorithmOptions2() method ..................92 2.7.5 SetRoutingAvoidTypeOptions() method....................93 2.7.6 GetRoutingAvoidTypeOptions() method ...................94 2.7.7 SetStyleMapOptions() method ................................95 2.7.8 GetStyleMapOptions() method................................95 2.7.9 SetKeyboardMapModeOptions() method ..................96 2.7.10 GetKeyboardMapModeOptions() method ................96 2.7.11 GetBasicMapFolderOptions() method .....................97 2.7.12 SetBasicMapFolderOptions() method .....................97 2.7.13 GetMapsNumberOptions() method ........................98 2.7.14 GetMapsPathsOptions() method ............................98 2.7.15 SetCurrentMapOptions() method...........................99 2.7.16 GetCurrentMapOptions() method ..........................99 2.7.17 GetRadioMutingOptions() method .......................100 2.7.18 SetRadioMutingOptions() method ........................100 2.7.19 GetLanguageCodeOptions() method ....................101 2.7.20 SetLanguageCodeOptions() method ....................101 2.7.21 GetDistUnitOptions() method..............................102 2.7.22 SetDistUnitOptions() method ..............................102 2.7.23 SetLouderOptions() method ...............................103 2.7.24 SetQuieterOptions() method...............................103 2.7.25 SetPoiMapFolderOptions() method ......................104 2.7.26 OpenPoiMapsOptions() method ...........................104 2.7.27 ClosePoiMapsOptions() method ...........................105 IGPS ............................................................................106 2.8.1 OpenGPS() method .............................................107 2.8.2 CloseGPS() method .............................................107 2.8.3 GetStatusGPS() method ......................................108 2.8.4 SetGpsReceiverType() method .............................109 2.8.5 GetGpsReceiverType() method .............................109 2.8.6 SetGpsReceiverPort() method ..............................110 2.8 Table of contents - III - User's manual NAVIGON Integration Kit 4.0 2.8.7 GetGpsReceiverPort() method ..............................110 2.8.8 SetGpsReceiverBaudRate() method.......................111 2.8.9 GetGpsReceiverBaudRate() method ......................111 2.8.10 SetDataSourceGps() method ..............................112 2.8.11 SetDataGps() method ........................................113 2.9 ITMC............................................................................114 2.9.1 OpenTmc() method .............................................115 2.9.2 OpenTmc2() method ...........................................116 2.9.3 CloseTmc() method.............................................116 2.9.4 GetStatusTmc() method ......................................117 2.9.5 UpdateTmc() method ..........................................118 2.9.6 GetRadioStationTmc() method..............................118 2.9.7 SearchFirstMessageTmc() method.........................120 2.9.8 SearchNextMessageTmc() method ........................121 2.9.9 GetLastKnownFreqTmc() method ..........................1 ...