Bedienungsanleitung NAVIGON INTEGRATION KIT 4.0

[. . . ] Anwenderhandbuch NAVIGON Integration Kit 4. 0 Stand September 2004 Impressum NAVIGON GmbH Berliner Platz 11 D-97080 Würzburg Hotline (dtms-Service, 0, 12 /min): 0180-5-NAVIKIT (0180-5-6284548) Die in diesen Unterlagen enthaltenen Angaben und Daten können ohne vorherige Ankündigung geändert werden. Ohne ausdrückliche schriftliche Genehmigung der NAVIGON GmbH darf kein Teil dieser Unterlagen für irgendwelche Zwecke vervielfältigt oder übertragen werden, unabhängig davon, auf welche Art und Weise oder mit welchen Mitteln, elektronisch oder mechanisch, dies geschieht. Alle technischen Angaben, Zeichnungen usw. unterliegen dem Gesetz zum Schutz des Urheberrechts. [. . . ] IROUTING::GetNextWayListNavigation HRESULT GetNextWayListNavigation [out] BSTR * [out] BSTR * [out] long * [out] BSTR * [out] int * [out] BOOL * a_FromStreet, a_ToStreet, a_nMeterFrom, a_AdviceDesc, a_dAction, a_bFind ) ( C++ Syntax Typ - 82 - Schnittstelle INAVIGATION Anwenderhandbuch NAVIGON Integration Kit 4. 0 Parameter Die folgenden Parameter können mit der Methode verwendet werden: Parameter a_FromStreet a_ToStreet a_nMeterFrom a_AdviceDesc a_dAction Bedeutung Zeiger auf eine BSTR Variable, die die Straße enthält von wo aus der Wegpunkt startet. Zeiger auf eine BSTR Variable, die die Straße enthält in die der Wegpunkt führt. Zeiger auf eine long Variable, die die Entfernung zur nächsten Aktion enthält. Zeiger auf eine BSTR Variable, die eine Beschreibung der Ansage enthält. Zeiger auf eine int Variable, die die auszuführende Aktion enthält (siehe Aufzählungstypen auf Seite 169). Zeiger auf eine BOOL Variable, die angibt, ob ein Wegpunkt gefunden wurde. a_bFind Rückgabewerte Die Methode liefert die folgenden Rückgabewerte: Rückgabewerte S_OK S_FALSE Bedeutung Erfolg Misserfolg Anmerkungen Solange die Variable a_bFind TRUE ist, können weitere Wegpunkte ermittelt werden. 2. 6. 31 Methode SetZoomLevelInNavigation() Beschreibung Die Methode SetZoomLevelInNavigation() setzt die Zoom-Stufe für die Karte. INAVIGATION::SetZoomLevelInNavigation HRESULT SetZoomLevelInNavigation([in] double a_level) C++ Syntax Typ Parameter Die folgenden Parameter können mit der Methode verwendet werden: Parameter a_level Bedeutung Legt die Zoom-Stufe der Karte in Metern pro Pixel fest. Rückgabewerte Die Methode liefert die folgenden Rückgabewerte: Rückgabewerte S_OK S_FALSE Bedeutung Erfolg Misserfolg Programmierschnittstellen - 83 - Anwenderhandbuch NAVIGON Integration Kit 4. 0 2. 6. 32 Methode GetZoomLevelInNavigation() Beschreibung Die Methode GetZoomLevelInNavigation() liefert die ZoomStufe für die Karte zurück. INAVIGATION::GetZoomLevelInNavigation HRESULT GetZoomLevelInNavigation([in] double a_level) C++ Syntax Typ Parameter Die folgenden Parameter können mit der Methode verwendet werden: Parameter a_level Bedeutung Zeiger auf eine double Variable, die die aktuell eingestellte Zoom-Stufe der Karte in Metern pro Pixel enthält. Rückgabewerte Die Methode liefert die folgenden Rückgabewerte: Rückgabewerte S_OK S_FALSE Bedeutung Erfolg Misserfolg 2. 6. 33 Methode SetMaxResolutionNavigation() Beschreibung Die Methode SetMaxResolutionNavigation() setzt die maximale Auflösung der Karte in Pixel pro Meter. INAVIGATION::SetMaxResolutionNavigation HRESULT SetMaxResolutionNavigation( [in] double a_maxres Parameter ) C++ Syntax Typ Die folgenden Parameter können mit der Methode verwendet werden: Parameter a_level Bedeutung Legt die maximale Auflösung der Karte in Pixel pro Meter fest. Rückgabewerte Die Methode liefert die folgenden Rückgabewerte: Rückgabewerte S_OK S_FALSE Bedeutung Erfolg Misserfolg - 84 - Schnittstelle INAVIGATION Anwenderhandbuch NAVIGON Integration Kit 4. 0 2. 6. 34 Methode GetMaxResolutionNavigation() Beschreibung Die Methode GetMaxResolutionNavigation() liefert die maximale Auflösung der Karte in Pixel pro Meter zurück. IPOSITION::GetMaxResolutionNavigation HRESULT GetMaxResolutionNavigation( [in] double a_maxres ) Parameter Die folgenden Parameter können mit der Methode verwendet werden: Parameter a_level Bedeutung Zeiger auf eine double Variable, die die maximale Auflösung der Karte in Pixel pro Meter enthält. C++ Syntax Typ Rückgabewerte Die Methode liefert die folgenden Rückgabewerte: Rückgabewerte S_OK S_FALSE Bedeutung Erfolg Misserfolg 2. 6. 35 Methode ChangeGeoToMapCoordNavigation() Beschreibung Die Methode ChangeGeoToMapCoordNavigation() konvertiert eine geografische Koordinate in eine Fensterkoordinate. INAVIGATION::ChangeGeoToMapCoordNavigation HRESULT ChangeGeoToMapCoordNavigation( [in] double [in] double [out] int * [out] int * Parameter a_lat, a_long, a_x, a_y ) C++ Syntax Typ Die folgenden Parameter können mit der Methode verwendet werden: Parameter a_lat a_long a_x Bedeutung Legt den Breitengrad im Format WGS-84 für eine Umwandlung fest. Legt den Längengrad im Format WGS-84 für eine Umwandlung fest. Zeiger auf eine int Variable, die die konvertierte X-Koordinate des Fensters enthält. - 85 - Programmierschnittstellen Anwenderhandbuch NAVIGON Integration Kit 4. 0 Parameter a_y Bedeutung Zeiger auf eine int Variable, die die konvertierte Y-Koordinate des Fensters enthält. Rückgabewerte Die Methode liefert die folgenden Rückgabewerte: Rückgabewerte S_OK S_FALSE Bedeutung Erfolg Misserfolg 2. 6. 36 Methode ChangeMapToGeoCoordLocationMap() Beschreibung Die Methode ChangeMapToGeoCoordNavigation() konvertiert eine Fensterkoordinate in eine geografische Koordinate. INAVIGATION::ChangeMapToGeoCoordNavigation HRESULT ChangeMapToGeoCoordNavigation( [in] int [in] int a_x, a_y, a_lat, a_long ) C++ Syntax Typ [out] double * [out] double * Parameter Die folgenden Parameter können mit der Methode verwendet werden: Parameter a_x a_y a_lat Bedeutung Legt die X-Koordinate des Fensters fest, die konvertiert werden soll. Legt die Y-Koordinate des Fensters fest, die konvertiert werden soll. Zeiger auf eine double Variable, die den konvertierten Breitengrad im Format WGS-84 enthält. Zeiger auf eine double Variable, die den konvertierten Längengrad im Format WGS-84 enthält. a_long Rückgabewerte Die Methode liefert die folgenden Rückgabewerte: Rückgabewerte S_OK S_FALSE Bedeutung Erfolg Misserfolg - 86 - Schnittstelle INAVIGATION Anwenderhandbuch NAVIGON Integration Kit 4. 0 2. 6. 37 Beispiele Routenberechnung und Navigation m_NIK_Navigation->OpenNavigation( (long)hWnd, 0, 0, 300, 200 ); /* Setzen des Zielpunktes */ m_NIK_Navigation->SetDestCoordNavigation(dLat, dLong ); /* Starte die Routenberechnung und Navigation */ m_NIK_Navigation->StartNavigation(); /* Hole den Status der Routenberechnung */ m_NIK_Navigation->GetStatusNavigation( &nStatus ); /* Hole die Distanz und geschätzte Dauer der Route */ m_NIK_Navigation->GetRoutingResultNavigation ( &nMeter, &nSec ); m_NIK_Navigation->CloseNavigation(); Angabe des Zielpunktes /* Zielpunkt als Koordinate */ m_NIK_Navigation->SetDestCoordNavigation(dLatX, dLongY); /* Zielpunkt als ID */ m_NIK_Navigation->SetDestIdNavigation( nAreaId ); /* Rückgabe des Zielpunktes */ m_NIK_Navigation->GetDestCoordNavigation( &dLatX, &dLongY ); /* bzw. */ m_NIK_Navigation->GetDestIdNavigation( &nAreaId ); Darstellung /* Anzeige der gesamten Route */ m_NIK_Navigation->ShowRouteNavigation(); /* Start- und Zielpunkt der Route */ m_NIK_Navigation->ShowStartPointNavigation(); m_NIK_Navigation->ShowEndPointNavigation(); Programmierschnittstellen - 87 - Anwenderhandbuch NAVIGON Integration Kit 4. 0 Karte /* Verschieben des Kartenausschnitts */ 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(); /* Kartenausrichtung -norden- */ m_NIK_Navigation->SetRotationNavigation( FALSE ); m_NIK_Navigation->GetRotationNavigation( &bDir ); Ansage Navigationsanweisung /* Aktuelle Ansage auslösen */ m_NIK_Navigation->RepeatLastAdviceNavigation(); - 88 - Schnittstelle INAVIGATION Anwenderhandbuch NAVIGON Integration Kit 4. 0 2. 7 Schnittstelle IOPTIONS Über die Programmierschnittstelle IOPTIONS werden globale Parameter festgelegt, für die Routenberechnung in den Schnittstellen IROUTING und INAVIGATION, für die Darstellung der Karten in den Schnittstellen IROUTING, INAVIGATION und IPOSITION. Überblick Funktionsumfang Einstellungen für Routenberechnung Einstellungen für die Kartendarstellung Hinweis: Für jede Einstellungsmöglichkeit gibt es entsprechende Get- und Set-Methoden Typische Verwendung 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 ); Methoden In der Schnittstelle IOPTIONS stehen Ihnen die folgenden Methoden zur Verfügung: Methode SetRoutingAlgorithmOptions(), siehe Seite 90 Methode SetRoutingAlgorithmOptions2(), siehe Seite 91 Methode GetRoutingAlgorithmOptions(), siehe Seite 91 Methode GetRoutingAlgorithmOptions2(), siehe Seite 92 Methode SetRoutingAvoidTypeOptions(), siehe Seite 93 Methode GetRoutingAvoidTypeOptions(), siehe Seite 94 Methode SetStyleMapOptions(), siehe Seite 95 Methode GetStyleMapOptions(), siehe Seite 95 Methode SetKeyboardMapModeOptions(), siehe Seite 96 Methode GetKeyboardMapModeOptions(), siehe Seite 96 Methode GetBasicMapFolderOptions(), siehe Seite 97 Methode SetBasicMapFolderOptions(), siehe Seite 97 Methode GetMapsNumberOptions(), siehe Seite 98 Methode GetMapsPathsOptions(), siehe Seite 98 Methode SetCurrentMapOptions(), siehe Seite 99 Methode GetCurrentMapOptions(), siehe Seite 99 Programmierschnittstellen - 89 - Anwenderhandbuch NAVIGON Integration Kit 4. 0 Methode GetRadioMutingOptions(), siehe Seite 100 Methode SetRadioMutingOptions(), siehe Seite 100 Methode GetLanguageCodeOptions(), siehe Seite 101 Methode SetLanguageCodeOptions(), siehe Seite 101 Methode GetDistUnitOptions(), siehe Seite 102 Methode SetDistUnitOptions(), siehe Seite 102 Methode SetLouderOptions(), siehe Seite 103 Methode SetQuieterOptions(), siehe Seite 103 Methode SetPoiMapFolderOptions(), siehe Seite 104 Methode OpenPoiMapsOptions(), siehe Seite 104 Methode OpenPoiMapsOptions(), siehe Seite 104 2. 7. 1 Methode SetRoutingAlgorithmOptions() Achtung: Veraltete Methode!Erweiterte Einstellungen sind über die Methode SetRoutingAlgorithmOptions2() möglich, die deshalb auch für neue Projekte verwendet werden sollte. Beschreibung Die Methode SetRoutingAlgorithmOptions() für die Routenberechnung ein. Einer der folgenden Parameter muss TRUE sein. IOPTIONS:: SetRoutingAlgorithmOptions HRESULT SetRoutingAlgorithmOptions( [in] BOOL [in] BOOL [in] BOOL bDynamicRoute, bQuickest, bShortest ) C++ Syntax Typ Parameter Die folgenden Parameter können mit der Methode verwendet werden: Parameter bDynamicRoute Bedeutung Legt fest, ob eine dynamische Route berechnet werden soll. [. . . ] Die DemoApplikation enthält die folgenden Daten: C++ Quellcode Die meisten Schnittstellen und deren Methoden sind enthalten. Der Quellcode stellt eine hilfreiche Unterstützung für Software-Entwickler dar, die das NIK in ihre Applikation integrieren wollen. Kompilierte Version der Demo-Applikation Überblick Anforderungen Folgende Systemanforderungen müssen für die Demo-Applikation erfüllt sein: Notebook: Windows Mobile 2003: Microsoft Visual Studio 6. 0 Microsoft eMbedded Visual C++ 4. 0 - 174 - Anhang B: Benutzerdefinierte POIs (optional) Anwenderhandbuch NAVIGON Integration Kit 4. 0 4 Glossar COM-Port ist die Bezeichnung für eine serielle Schnittstelle. Mit der Zahl hinter COM werden die Anschlüsse durchnummeriert. [. . . ]