User manual NAVIGON INTEGRATION KIT 4.0

[. . . ] 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [. . . ] Pointer to a BSTR variable which contains the text (a description) of the voice instruction. Pointer to an INT variable which contains the manoeuvre to be executed. Pointer to a BOOL variable which indicates whether a way point has been retrieved. a_ToStreet a_nMeterFrom a_AdviceDesc a_dAction a_bFind Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error Notes You may retrieve further way points as long as the a_bFind variable is TRUE. 2. 6. 31 SetZoomLevelInNavigation() method Description The SetZoomLevelInNavigation() method sets the zoom level of the displayed map. INAVIGATION::SetZoomLevelInNavigation HRESULT SetZoomLevelInNavigation([in] double The method takes the following parameter: Parameter a_level Signification Specifies the zoom level of the displayed map in meters per pixel. a_level) C++ syntax Type Parameters Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error Programming interfaces - 83 - User's manual NAVIGON Integration Kit 4. 0 2. 6. 32 GetZoomLevelInNavigation() method Description The GetZoomLevelInNavigation() method retrieves the current zoom level of the displayed map. INAVIGATION::GetZoomLevelInNavigation HRESULT GetZoomLevelInNavigation([in] double The method takes the following parameter: Parameter a_level Signification Pointer to a DOUBLE variable which contains the current zoom level of the displayed map in meters per pixel. a_level) C++ syntax Type Parameters Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error 2. 6. 33 SetMaxResolutionNavigation() method Description The SetMaxResolutionNavigation() method sets the maximum resolution of the map (in pixels per meter). INAVIGATION::SetMaxResolutionNavigation HRESULT SetMaxResolutionNavigation( [in] double a_maxres Parameters ) C++ syntax Type The method takes the following parameter: Parameter a_level Signification Specifies the maximum resolution of the map (in pixels per meter). Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error - 84 - INAVIGATION User's manual NAVIGON Integration Kit 4. 0 2. 6. 34 GetMaxResolutionNavigation() method Description The GetMaxResolutionNavigation() method retrieves the maximum resolution of the map (in pixels per meter). IPOSITION::GetMaxResolutionNavigation HRESULT GetMaxResolutionNavigation( [in] double a_maxres ) Parameters The method takes the following parameter: Parameter a_level Signification Pointer to a DOUBLE variable which contains the maximum resolution of the map (in pixels per meter). C++ syntax Type Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error 2. 6. 35 ChangeGeoToMapCoordNavigation() method Description The ChangeGeoToMapCoordNavigation() method converts the given geographic coordinates of a point into window coordinates. INAVIGATION::ChangeGeoToMapCoordNavigation HRESULT ChangeGeoToMapCoordNavigation( [in] double [in] double [out] int * [out] int * Parameters a_lat, a_long, a_x, a_y ) C++ syntax Type The method takes the following parameters: Parameter a_lat a_long a_x a_y Signification Specifies the latitude of the point in WGS-84 format. Pointer to an INT variable which contains the X-coordinate of the point in the map window. Pointer to an INT variable which contains the Y-coordinate of the point in the map window. Programming interfaces - 85 - User's manual NAVIGON Integration Kit 4. 0 Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error 2. 6. 36 ChangeMapToGeoCoordLocationMap() method Description The ChangeMapToGeoCoordNavigation() method converts the given window coordinates of a point into geographic coordinates. INAVIGATION::ChangeMapToGeoCoordNavigation HRESULT ChangeMapToGeoCoordNavigation( [in] int [in] int a_x, a_y, a_lat, a_long ) C++ syntax Type [out] double * [out] double * Parameters The method takes the following parameters: Parameter a_x a_y a_lat a_long Signification Specifies the X-coordinate of the point in the map window. Pointer to a DOUBLE variable which contains the latitude of the point in WGS-84 format. Pointer to a DOUBLE variable which contains the longitude of the point in WGS-84 format. Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error - 86 - INAVIGATION User's manual NAVIGON Integration Kit 4. 0 2. 6. 37 Examples Route calculation and navigation m_NIK_Navigation->OpenNavigation( (long)hWnd, 0, 0, 300, 200 ); /* Specify the destination */ m_NIK_Navigation->SetDestCoordNavigation(dLat, dLong ); /* Start route calculation and navigation */ m_NIK_Navigation->StartNavigation(); /* Retrieve the status of route calculation */ m_NIK_Navigation->GetStatusNavigation( &nStatus ); /* Retrieve the distance and the estimated duration of the travel */ m_NIK_Navigation->GetRoutingResultNavigation ( &nMeter, &nSec ); m_NIK_Navigation->CloseNavigation(); Specify the destination /* Geographic point */ m_NIK_Navigation->SetDestCoordNavigation(dLatX, dLongY); /* ID */ m_NIK_Navigation->SetDestIdNavigation( nAreaId ); /* Retrieve the destination */ m_NIK_Navigation->GetDestCoordNavigation( &dLatX, &dLongY ); /* or */ m_NIK_Navigation->GetDestIdNavigation( &nAreaId ); Display /* Display the whole route */ m_NIK_Navigation->ShowRouteNavigation(); /* Start and destination points of the route m_NIK_Navigation->ShowStartPointNavigation(); m_NIK_Navigation->ShowEndPointNavigation(); */ Programming interfaces - 87 - User's manual NAVIGON Integration Kit 4. 0 Map /* Scroll the map */ m_NIK_Navigation->ShowDownNavigation(); m_NIK_Navigation->ShowUpNavigation(); m_NIK_Navigation->ShowLeftNavigation(); m_NIK_Navigation->ShowRightNavigation(); /* Zoom */ m_NIK_Navigation->ZoomInNavigation(); m_NIK_Navigation->ZoomOutNavigation(); /* Orientate the map north up */ m_NIK_Navigation->SetRotationNavigation( FALSE ); m_NIK_Navigation->GetRotationNavigation( &bDir ); Voice instruction /* Repeat the last voice instruction */ m_NIK_Navigation->RepeatLastAdviceNavigation(); - 88 - INAVIGATION User's manual NAVIGON Integration Kit 4. 0 2. 7 Survey IOPTIONS The IOPTIONS interface is designed to set global parameters for route calculation (IROUTING and INAVIGATION), map representation (IROUTING, INAVIGATION, and IPOSITION). Exposed functionality Configuration of route calculation Configuration of map representation Notice: There are get and set methods for each of the configuration items. Typical use GetRoutingAlgorithmOptions ( &bDynamicRoute, &bQuickest, &bShortest ); /* Einstellungen für die Routenberechnung ändern */ SetRoutingAlgorithmOptions ( bDynamicRoute, bQuickest, bShortest ); GetRoutingAvoidTypeOptions ( &bHighWays, &bFerries, &bMaudStreets ); /* Einstellungen für Ausschluss von Verbindungswegen */ SetRoutingAvoidTypeOptions ( bHighWays, bFerries, bMaudStreets ); Methods The IOPTIONS interface defines the following methods: SetRoutingAlgorithmOptions() method, see page 90 SetRoutingAlgorithmOptions2() method, see page 91 GetRoutingAlgorithmOptions() method, see page 91 GetRoutingAlgorithmOptions2() method, see page 92 SetRoutingAvoidTypeOptions() method, see page 93 GetRoutingAvoidTypeOptions() method, see page 94 SetStyleMapOptions() method, see page 95 GetStyleMapOptions() method, see page 95 SetKeyboardMapModeOptions() method, see page 96 GetKeyboardMapModeOptions() method, see page 96 GetBasicMapFolderOptions() method, see page 97 SetBasicMapFolderOptions() method, see page 97 GetMapsNumberOptions() method, see page 98 GetMapsPathsOptions() method, see page 98 SetCurrentMapOptions() method, see page 99 GetCurrentMapOptions() method, see page 99 GetRadioMutingOptions() method, see page 100 SetRadioMutingOptions() method, see page 100 Programming interfaces - 89 - User's manual NAVIGON Integration Kit 4. 0 GetLanguageCodeOptions() method, see page 101 SetLanguageCodeOptions() method, see page 101 GetDistUnitOptions() method, see page 102 SetDistUnitOptions() method, see page 102 SetLouderOptions() method, see page 103 SetQuieterOptions() method, see page 103 SetPoiMapFolderOptions() method, see page 104 OpenPoiMapsOptions() method, see page 104 OpenPoiMapsOptions() method, see page 104 2. 7. 1 SetRoutingAlgorithmOptions() method Attention: Old method!The SetRoutingAlgorithmOptions2() method offers enhanced configuration possibilities and should therefore be used in current and future projects. Description The SetRoutingAlgorithmOptions() method specifies the kind of route to be calculated. IOPTIONS:: SetRoutingAlgorithmOptions HRESULT SetRoutingAlgorithmOptions( [in] BOOL [in] BOOL [in] BOOL bDynamicRoute, bQuickest, bShortest ) C++ syntax Type Parameters The method takes the following parameters: Parameter bDynamicRoute Signification Specifies a dynamic route to be calculated (TRUE) or not (FALSE). A dynamic route is a quick route, but TMC broadcasts are permanently being considered (if received). The route may automatically be recalculated due to broadcasted traffic obstructions on the route which originally was calculated. Specifies the shortest route to be calculated (TRUE) or not (FALSE). bQuickest bShortest Attention: Exactly one of these parameters must be TRUE. - 90 - IOPTIONS User's manual NAVIGON Integration Kit 4. 0 Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error 2. 7. 2 SetRoutingAlgorithmOptions2() method The SetRoutingAlgorithmOptions2() method specifies the kind of route to be calculated. IOPTIONS:: SetRoutingAlgorithmOptions2 HRESULT SetRoutingAlgorithmOptions2 [in] int a_nRouteType ) ( Description C++ syntax Type Parameters The method takes the following parameter: Parameter a_nRouteType Signification Specifies the kind of route to be calculated. Must be a member of the _RouteType enumeration (see page 171). Return values The method returns one of the following values: Return value S_OK S_FALSE Signification Done Error 2. 7. 3 GetRoutingAlgorithmOptions() method Attention: Old method! [. . . ] POI of one category are represented on the map by always the same symbol. Notice: User defined POI are an additional module for Configuration Kit which may be purchased separately. Database of POI User defined POI must be stored in a database. A new database can be created by the POI Importer software (by Navigon GmbH). POI Importer imports text files into a new database which contains the relevant information only. [. . . ]