Navigon INTEGRATION KIT 4.0 User Manual [no]

Anwenderhandbuch

NAVIGON Integration Kit 4.0

Stand September 2004

irgendwelche Zwecke vervielfältigt oder übertragen werden, unabhängig davon, auf welche Art und Weise oder

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

mit welchen Mitteln, elektronisch oder mechanisch, dies geschieht. Alle technischen Angaben, Zeichnungen
usw. unterliegen dem Gesetz zum Schutz des Urheberrechts.
 Copyright 2004, NAVIGON GmbH
Alle Rechte vorbehalten.

Inhaltsverzeichnis

1 Einleitung....................................................................6

1.1

Zu diesem Benutzerhandbuch ............................................ 7

1.2

Leistungsbeschreibung ...................................................... 7

1.2.1 Unterstützte Betriebssysteme.................................. 8

1.3

Systemvoraussetzungen.................................................... 9

1.4

Installation ...................................................................... 9

1.4.1 Installationsergebnis Notebook ...............................10

1.4.2 Installationsergebnis Windows CE ...........................10

1.5

Zugriffshilfen und Konventionen ........................................11

1.6

Gewährleistung ...............................................................11

1.6.1 Support ...............................................................12

1.7

Warenzeichen .................................................................12

Anwenderhandbuch NAVIGON Integration Kit 4.0

2 Programmierschnittstellen........................................13

2.1

Voraussetzungen der Entwicklungsumgebung .....................14

2.1.1 Allgemeines zur Benutzung der Interfaces................14

2.1.2 Schnittstellen im Überblick.....................................15

2.2

Schnittstelle IMNNIK ........................................................15

2.2.1 Methode MNOpen() ...............................................16

2.2.2 Methode MNClose() ...............................................16

2.2.3 Methode GetMNOpen() ..........................................17

2.2.4 Methode GetMNVersion() .......................................17

2.2.5 Öffnen und schließen des NIK .................................18

2.3

Schnittstelle IADDRESS ....................................................19

2.3.1 Methode OpenAddress() ........................................20

2.3.2 Methode CloseAdress() ..........................................20

2.3.3 Methode SearchFirstCityAddress()...........................21

2.3.4 Methode SearchFirstCityPostalCodeAddress() ...........22

2.3.5 Methode SearchNextCityAddress() ..........................23

2.3.6 Methode SearchFirstStreetAddress() .......................25

2.3.7 Methode SearchNextStreetAddress() .......................26

2.3.8 Methode SearchPoiByRadiusAddress() .....................28

2.3.9 Methode SearchNextPoiAddress() ...........................29

2.3.10 Methode ConvertCoordInAddress()........................30

2.3.11 Methode ConvertCoordInAddress2() ......................32

2.3.12 Methode ConvertCoordInCountry()........................33

2.4

Schnittstelle IROUTING ....................................................34

2.4.1 Methode OpenRoute() ...........................................35

2.4.2 Methode CloseRoute() ...........................................36

2.4.3 Methode AddDestCoordRoute()...............................36

2.4.4 Methode GetDestCoordRoute() ...............................37

2.4.5 Methode ClearDestCoordRoute() .............................38

2.4.6 Methode StartRoute()............................................38

2.4.7 Methode ShowRoute() ...........................................39

2.4.8 Methode ClearRoute() ...........................................39

2.4.9 Methode ZoomInRoute()........................................40

2.4.10 Methode ZoomOutRoute() ....................................40

2.4.11 Methode ShowDownRoute() .................................40

Inhaltsverzeichnis - I -

Anwenderhandbuch NAVIGON Integration Kit 4.0

2.5

2.6

2.4.12 Methode ShowUpRoute() .....................................41

2.4.13 Methode ShowLeftRoute() ....................................41

2.4.14 Methode ShowRightRoute() ..................................41

2.4.15 Methode ShowStartPointRoute() ...........................42

2.4.16 Methode ShowEndPointRoute() .............................42

2.4.17 Methode SetRotationRoute().................................43

2.4.18 Methode GetRotationRoute() ................................43

2.4.19 Methode GetStatusRoute() ...................................44

2.4.20 Methode GetResultRoute() ...................................44

2.4.21 Methode MapShowRoute()....................................45

2.4.22 Methode GetFirstWayListRoute()...........................45

2.4.23 Methode GetNextWayListRoute()...........................46

2.4.24 Methode SetZoomLevelInRoute() ..........................47

2.4.25 Methode GetZoomLevelInRoute()..........................48

2.4.26 Methode SetMaxResolutionRoute() ........................48

2.4.27 Methode GetMaxResolutionRoute()........................49

2.4.28 Methode ChangeGeoToMapCoordRoute() ...............49

2.4.29 Methode ChangeMapToGeoCoordRoute()................50

2.4.30 Beispiel einer Routenberechnung ..........................51

Schnittstelle IPOSITION ...................................................52

2.5.1 Methode OpenPosition().........................................53

2.5.2 Methode ClosePosition() ........................................54

2.5.3 Methode StartPosition() .........................................54

2.5.4 Methode GetPosition() ...........................................55

2.5.5 Methode ZoomInPosition() .....................................55

2.5.6 Methode ZoomOutPosition() ...................................56

2.5.7 Methode ShowDownPosition() ................................56

2.5.8 Methode ShowUpPosition().....................................56

2.5.9 Methode ShowLeftPosition() ...................................57

2.5.10 Methode ShowRightPosition() ...............................57

2.5.11 Methode SetRotationPosition()..............................57

2.5.12 Methode GetRotationPosition()..............................58

2.5.13 Methode MapShowPosition() .................................59

2.5.14 Methode SetBirdViewPosition() .............................59

2.5.15 Methode SetZoomLevelInPosition() .......................60

2.5.16 Methode GetZoomLevelInPosition() .......................60

2.5.17 Methode SetMaxResolutionPosition() .....................61

2.5.18 Methode GetMaxResolutionPosition() .....................61

2.5.19 Methode ChangeGeoToMapCoordPosition().............62

2.5.20 Methode ChangeMapToGeoCoordPosition().............62

Schnittstelle INAVIGATION ...............................................64

2.6.1 Methode OpenNavigation().....................................66

2.6.2 Methode CloseNavigation() ....................................67

2.6.3 Methode SetDestIdNavigation() ..............................67

2.6.4 Methode GetDestIdNavigation()..............................68

2.6.5 Methode SetDestCoordNavigation().........................68

2.6.6 Methode GetDestCoordNavigation() ........................69

2.6.7 Methode SetDestTrackNavigation() .........................70

2.6.8 Methode StartNavigation() .....................................71

2.6.9 Methode ShowRouteNavigation() ............................71

2.6.10 Methode RepeatLastAdviceNavigation()..................72

2.6.11 Methode ZoomInNavigation() ...............................72

2.6.12 Methode ZoomOutNavigation() .............................72

2.6.13 Methode ShowDownNavigation()...........................73

2.6.14 Methode ShowUpNavigation()...............................73

2.6.15 Methode ShowLeftNavigation() .............................73

2.6.16 Methode ShowRightNavigation() ...........................74

- II - Inhaltsverzeichnis

Anwenderhandbuch NAVIGON Integration Kit 4.0

2.7

2.8

2.6.17 Methode ShowStartPointNavigation().....................74

2.6.18 Methode ShowEndPointNavigation() ......................74

2.6.19 Methode SetRotationNavigation()..........................75

2.6.20 Methode GetRotationNavigation()..........................75

2.6.21 Methode GetStatusNavigation() ............................76

2.6.22 Methode GetRoutingResultNavigation()..................76

2.6.23 Methode ShematicViewOpenNavigation() ...............77

2.6.24 Methode ShematicViewShowNavigation() ...............78

2.6.25 Methode DistanceBarOpenNavigation() ..................79

2.6.26 Methode DistanceBarShowNavigation()..................80

2.6.27 Methode MapShowNavigation().............................80

2.6.28 Methode SetBirdViewNavigation() .........................81

2.6.29 Methode GetFirstWayListNavigation() ....................81

2.6.30 Methode GetNextWayListNavigation()....................82

2.6.31 Methode SetZoomLevelInNavigation() ...................83

2.6.32 Methode GetZoomLevelInNavigation() ...................84

2.6.33 Methode SetMaxResolutionNavigation() .................84

2.6.34 Methode GetMaxResolutionNavigation() .................85

2.6.35 Methode ChangeGeoToMapCoordNavigation().........85

2.6.36 Methode ChangeMapToGeoCoordLocationMap() ......86

2.6.37 Beispiele ............................................................87

Schnittstelle IOPTIONS.....................................................89

2.7.1 Methode SetRoutingAlgorithmOptions() ...................90

2.7.2 Methode SetRoutingAlgorithmOptions2() .................91

2.7.3 Methode GetRoutingAlgorithmOptions()...................91

2.7.4 Methode GetRoutingAlgorithmOptions2() .................92

2.7.5 Methode SetRoutingAvoidTypeOptions() ..................93

2.7.6 Methode GetRoutingAvoidTypeOptions() ..................94

2.7.7 Methode SetStyleMapOptions()...............................95

2.7.8 Methode GetStyleMapOptions() ..............................95

2.7.9 Methode SetKeyboardMapModeOptions() .................96

2.7.10 Methode GetKeyboardMapModeOptions() ...............96

2.7.11 Methode GetBasicMapFolderOptions()....................97

2.7.12 Methode SetBasicMapFolderOptions() ....................97

2.7.13 Methode GetMapsNumberOptions() .......................98

2.7.14 Methode GetMapsPathsOptions()...........................98

2.7.15 Methode SetCurrentMapOptions() .........................99

2.7.16 Methode GetCurrentMapOptions() .........................99

2.7.17 Methode GetRadioMutingOptions() ......................100

2.7.18 Methode SetRadioMutingOptions() ......................100

2.7.19 Methode GetLanguageCodeOptions()...................101

2.7.20 Methode SetLanguageCodeOptions() ...................101

2.7.21 Methode GetDistUnitOptions() ............................102

2.7.22 Methode SetDistUnitOptions().............................102

2.7.23 Methode SetLouderOptions() ..............................103

2.7.24 Methode SetQuieterOptions() .............................103

2.7.25 Methode SetPoiMapFolderOptions() .....................104

2.7.26 Methode OpenPoiMapsOptions()..........................104

2.7.27 Methode ClosePoiMapsOptions()..........................105

Schnittstelle IGPS..........................................................106

2.8.1 Methode OpenGPS()............................................107

2.8.2 Methode CloseGPS()............................................107

2.8.3 Methode GetStatusGPS() .....................................108

2.8.4 Methode SetGpsReceiverType() ............................109

2.8.5 Methode GetGpsReceiverType() ............................109

2.8.6 Methode SetGpsReceiverPort() .............................110

2.8.7 Methode GetGpsReceiverPort() .............................110

Inhaltsverzeichnis - III -

Anwenderhandbuch NAVIGON Integration Kit 4.0

2.8.8 Methode SetGpsReceiverBaudRate() .....................111

2.8.9 Methode GetGpsReceiverBaudRate() .....................111

2.8.10 Methode SetDataSourceGps() .............................112

2.8.11 Methode SetDataGps() ......................................113

2.9

Schnittstelle ITMC..........................................................114

2.9.1 Methode OpenTmc()............................................115

2.9.2 Methode OpenTmc2() ..........................................116

2.9.3 Methode CloseTmc() ...........................................116

2.9.4 Methode GetStatusTmc() .....................................117

2.9.5 Methode UpdateTmc() .........................................118

2.9.6 Methode GetRadioStationTmc() ............................119

2.9.7 Methode SearchFirstMessageTmc() .......................120

2.9.8 Methode SearchNextMessageTmc() .......................121

2.9.9 Methode GetLastKnownFreqTmc().........................123

2.9.10 Methode GetLastKnownPiCodeTmc()....................123

2.10 Schnittstelle ILOCATIONMAP...........................................124

2.10.1 Methode OpenLocationMap() ..............................125

2.10.2 Methode CloseLocationMap() ..............................126

2.10.3 Methode StartLocationMap()...............................126

2.10.4 Methode ShowCoordInLocationMap()...................126

2.10.5 Methode ShowObjectIDInLocationMap()...............128

2.10.6 Methode ZoomInLocationMap()...........................129

2.10.7 Methode ZoomOutLocationMap().........................129

2.10.8 Methode ShowDownLocationMap() ......................129

2.10.9 Methode ShowUpLocationMap() ..........................130

2.10.10 Methode ShowLeftLocationMap().......................130

2.10.11 Methode ShowRightLocationMap().....................130

2.10.12 Methode SetZoomLevelInLocationMap() .............131

2.10.13 Methode GetZoomLevelInLocationMap().............131

2.10.14 Methode SetMaxResolutionLocationMap() ...........132

2.10.15 Methode GetMaxResolutionLocationMap()...........132

2.10.16 Methode ChangeGeoToMapCoordLocationMap() ..133

2.10.17 Methode ChangeMapToGeoCoordLocationMap() ..133

2.10.18 Methode SetReceivePointLocationMap() .............134

2.10.19 Methode GetReceivePointLocationMap() .............135

2.10.20 Methode MapShowLocationMap() ......................135

2.11 Schnittstelle ITRACK ......................................................136

2.11.1 Methode RecordTrack()......................................137

2.11.2 Methode GetRecordTrackMode() .........................137

2.11.3 Methode GetCoordTrack() ..................................138

2.11.4 Methode SetAngleTrack() ...................................139

2.11.5 Methode GetAngleTrack()...................................139

2.11.6 Methode SetMaxNumberTrack() ..........................140

2.11.7 Methode GetMaxNumberTrack()..........................140

2.12 Schnittstelle ISIMULATION .............................................141

2.12.1 Methode CreateGPSFile() ...................................142

2.12.2 Methode StartSimulationGPS() ...........................143

2.12.3 Methode StopSimulationGPS () ...........................143

2.12.4 Methode StartSimulationTMC() ...........................144

2.12.5 Methode StopSimulationTMC()............................144

2.12.6 Methode SetSimulationSpeed() ...........................145

2.12.7 Methode GetSimulationSpeed()...........................145

2.12.8 Methode SetSimulationPosition().........................146

2.12.9 Methode GetSimulationPosition() ........................146

2.13 Schnittstelle IMNNIKEvents.............................................147

2.13.1 Klasse für Events deklarieren..............................148

- IV - Inhaltsverzeichnis

Anwenderhandbuch NAVIGON Integration Kit 4.0

2.13.2 Anbindung im Programm....................................148

2.13.3 Methode RTProgressCallback()............................149

2.13.4 Methode TMCMessageActivateCallback() ..............149

2.13.5 Methode TMCMessageDeactivateCallback()...........150

2.13.6 Methode GPSMessageCallback()..........................151

2.13.7 Methode NAVAudioAdviceCallback().....................151

2.13.8 Methode NAVVisualAdviceCallback() ....................152

2.13.9 Methode LButtonDownNavigationMapCallback() ....153

2.13.10 Methode MouseMoveNavigationMapCallback().....153

2.13.11 Methode LButtonDownRouteMapCallback() .........154

2.13.12 Methode MouseMoveRouteMapCallback()............155

2.13.13 Methode LButtonDownPositionMapCallback() ......155

2.13.14 Methode MouseMovePositionMapCallback().........156

2.13.15 Methode LButtonDownLocationMapCallback()......157

2.13.16 Methode MouseMoveLocationMapCallback() ........157

2.13.17 Methode MAPKeyBoardCallback() ......................158

2.13.18 Methode NAVOnDrawingCallback() ....................159

2.13.19 Methode RoutingOnDrawingCallback() ...............160

2.13.20 Methode PositionOnDrawingCallback() ...............161

2.13.21 Methode LocationOnDrawingCallback() ..............162

2.13.22 Methode NAVOnRunningCallback() ....................163

2.13.23 Methode NAVOnStopCallback() .........................163

3 Anhänge..................................................................165

3.1

3.2

3.3

Anhang A: Aufzählungstypen ..........................................166

Anhang B: Benutzerdefinierte POIs (optional) ...................174

Anhang D: Demo-Applikation..........................................174

4 Glossar....................................................................175

Inhaltsverzeichnis - V -

Anwenderhandbuch NAVIGON Integration Kit 4.0

1 Einleitung

In diesem Kapitel finden Sie Informationen zu den folgenden Themen:

1.1 Zu diesem Benutzerhandbuch Seite 7

1.2 Leistungsbeschreibung Seite 7
Unterstützte Betriebssysteme

1.3 Systemvoraussetzungen Seite 9

1.4 Installation Seite 9
Installationsergebnis Notebook
Installationsergebnis Windows CE

1.5 Zugriffshilfen und Konventionen Seite 11

1.6 Gewährleistung Seite 11
Support

1.7 Warenzeichen Seite 12

- 6 - Zu diesem Benutzerhandbuch

Anwenderhandbuch NAVIGON Integration Kit 4.0

1.1 Zu diesem Benutzerhandbuch

Einleitung In diesem Handbuch finden Sie eine Beschreibung des NAVIGON

Integration Kit (NIK). Es enthält neben der Installation und

Registrierung der COM DLL alle Funktionen der Schnittstellen und
erklärt die enthaltenen Methoden.

Hinweis: Auf Ihrer CD-ROM finden Sie eine Online-Hilfe, in der
ebenfalls alle Methoden enthalten sind. Sie können die Online­Hilfe nutzen, um schnell und effizient nach Inhalten zu suchen.

1.2 Leistungsbeschreibung

NIK im Überblick Das NAVIGON Integration KIT (NIK) ist eine weltweit

einzigartige Entwicklungsumgebung. Es bietet Ihrem Unter­nehmen die Möglichkeit, je nach Ansprüchen und Bedürfnissen
verschiedene Navigationsfunktionen zu nutzen. Speziell für Ihr
Unternehmen entwickeln NAVIGON und seine autorisierten
Partner eine jeweils individuelle und maßgeschneiderte Software­und Integrationslösung. Diese ist speziell auf Ihre Anforderungen
zugeschnitten.

Das NIK bietet Ihnen die einmalige Kombination aus schneller
Navigation und dem Zugriff auf Ihre Unternehmensdatenbank
und nutzt dafür die standardisierte COM-Schnittstelle.

COM-DLL Das NIK besteht aus einer COM-DLL mit diversen Interfaces, die

unabhängig von der verwendeten Programmiersprache (z. B.
C++, Visual Basic, Java) eingesetzt werden können. Dadurch
wird eine einfache Integration einer kompletten Navigations­lösung in Drittsysteme wie Tourenplanung, Auftragsplanung oder
Warenwirtschaft möglich (Übernahme und Übergabe von
Koordinaten oder Adressinformationen). Das NIK lässt sich so
vollständig in Ihre Softwareapplikation implementieren.

Die Kartendarstellung für die Navigation erfolgt in einem
beliebigen Fenster unter Angabe eines Window-Handle.

Funktionalitäten Das NIK unterstützt alle für die Navigation typischen

Funktionalitäten, die Sie individuell einsetzen können. Zusätzlich
ermöglicht Ihnen NIK die Darstellung von Daten aus Dritt­Systemen.

Einleitung - 7 -

Anwenderhandbuch NAVIGON Integration Kit 4.0

Methoden Das Integration Kit stellt eine große Anzahl an Methoden zur

Verfügung, um auf die Funktionalität des Navigator zuzugreifen.
Die folgenden Programmierschnittstellen stehen zur Verfügung:

Schnittstelle Beschreibung

IMNNIK Starten und Beenden der Navigationssoftware.

IADDRESS Zugriff auf Städte, Straßen und POIs.

IROUTING Erstellung und Berechnung von Routen.

IPOSITION Darstellung der aktuellen Position in der Karte.

INAVIGATION Navigation zu beliebigen Zielen.

IOPTIONS Festlegung globaler Parameter.

IGPS Zugriff auf aktuelle GPS-Daten.

ITMC Einbindung von TMC-Meldungen.

ILOCATIONMAP Darstellung einer individuellen Karte.

ITRACK Aufzeichnung von Spuren (Tracks).

ISIMULATION Ermöglicht die Verwendung von

Simulationsdateien für GPS und TMC.

IMNNIKEvents Handhabung von Ereignissen.

1.2.1 Unterstützte Betriebssysteme

Betriebssysteme Die folgenden Betriebssysteme werden unterstützt:
 MS Windows 2000 (mit Service Pack 4) und

XP (mit Service Pack 1)

 Windows Mobile 2003

Das NAVIGON Integration Kit wurde unter den folgenden

Systemumgebungen und Programmiersprachen getestet:

Plattform Betriebs-

system

Notebook and
PC

Notebook and
PC

Pocket PC

Windows 2000
Windows XP

Windows 2000
Windows XP

Windows
Mobile 2003

Programmier­sprache

C++ Microsoft Visual

Visual Basic Microsoft Visual

C++ Microsoft

Entwicklungs­umgebung

Studio 6.0

Basic 6.0

eMbedded Visual
C++ 4.0

Hinweis: Setzen Sie die Demo-Applikation ein, um weitere
Informationen zur Verwendung des NAVIGON Integration Kit
in Ihrer bevorzugten Umgebung zu erhalten.

- 8 - Leistungsbeschreibung

Anwenderhandbuch NAVIGON Integration Kit 4.0

1.3 Systemvoraussetzungen

PC Zur Entwicklung einer auf dem Integration Kit basierenden

Applikation auf dem PC werden die folgenden Systemvoraus­setzungen benötigt:

 Pentium PC 266 MHz

 MS Windows 2000 (mit Service Pack 4) oder

XP (mit Service Pack 1)

 32-fach CD-ROM Laufwerk
 DVD Laufwerk
 64 MB RAM (128 MB RAM empfohlen)

 VGA-Graphik Adapter mit mindestens 32000 Farben
 Microsoft kompatible Maus
 rund 40 MB Festplattenspeicher für das Programm
 rund 1.1 GB optional für die gesamte Europa-Karte

Pocket PC Zur Entwicklung einer auf dem Integration Kit basierenden

Applikation auf dem Pocket PC werden die folgenden
Systemvoraussetzungen benötigt:

 ARM Prozessor

 Windows Mobile 2003
 64 MB RAM (128 MB RAM empfohlen)

1.4 Installation

Überblick Das NAVIGON Integration Kit wird auf CD-ROMs geliefert und

enthält:

 NIK-DLL

 Europakarte

 Dateien für die Programmierung (header und tlb)
 Demo Applikation
 Software MapExport (nur für die Windows CE Versionen)

Installation 1. Starten Sie das Setup-Programm der ersten CD-ROM.

2. Wählen Sie zwischen der Option User´s mode und

Developer´s mode.

Sie wollen... dann...

nur die Laufzeit-Umgebung
für das NAVIGON
Integration Kit installieren,

die Entwicklungsumgebung
mit allen Dateien und der
Demo-Applikation installieren,

wählen Sie die Option User´s
mode aus.

wählen Sie die Option
Developer´s mode aus.

Einleitung - 9 -

Anwenderhandbuch NAVIGON Integration Kit 4.0

Demo-Applikation Nach erfolgreicher Installation können Sie die NAVIGON

Integration Kit Demo-Applikation starten, um einen ersten

Eindruck zu gewinnen, wie das NIK in Ihre Applikation integriert
werden kann.

Achtung: Verwenden Sie Windows CE, müssen Sie zuerst eine
Karte mit MapExport exportieren, bevor Sie die Demo­Applikation starten.

1.4.1 Installationsergebnis Notebook

Notebook, alle Modi Die Navigationssoftware ist installiert und die NIK-DLL registriert.

Die Europakarte und MapExport wurden in das Installations­verzeichnis installiert.

Notebook, Developer
Modus

 NIK-SDK Benutzerhandbuch

Im Developer Modus wurden die folgenden Dateien zusätzlich in
das Installationsverzeichnis kopiert

 Schnittstellen-Dateien (Header, TLB, LIB und DLL)
 Quellcode für die Demo-Applikation
 Demo-Applikation

1.4.2 Installationsergebnis Windows CE

Windows CE, alle
Modi

CE, Developer Modus Im Developer Modus werden die folgenden Dateien zusätzlich auf

 NIK-SDK Benutzerhandbuch

Die NIK Umgebeung ist installiert und die NIK-DLL registriert.

das Notebook installiert:

 Schnittstellen-Dateien (Header, TLB, LIB und DLL)
 Quellcode für die Demo-Applikation

 Demo-Applikation
 Europakarte
 MapExport

- 10 - Installation

Anwenderhandbuch NAVIGON Integration Kit 4.0

1.5 Zugriffshilfen und Konventionen

Diese Zugriffshilfen bietet Ihnen das Handbuch: Informationen

schnell finden

Konventionen In den beiden folgenden Tabellen finden Sie die durchgängig im

 An der Fußzeile im Handbuch können Sie erkennen, in

welchem Kapitel und welchem Abschnitt Sie sich gerade
befinden.

 Am Ende des Handbuchs finden Sie ein Glossar, in dem Sie

eine Erklärung verwendeter Fachbegriffe nachschlagen
können.

ganzen Handbuch verwendeten Konventionen in Bezug auf
verwendete Schreibweisen und Symbole.

Stil Verwendung
fett Schaltflächen, Felder und Oberflächen-

elemente der Software. Hervorhebung von
Warnungen und Hinweisen.

fett und kursiv Rechtlich geschützte Eigennamen.

K

APITÄLCHEN

Quellcode

Symbol Verwendung

Fenster- und Dialognamen.

Dateinamen und Quellcode.

Dieses Symbol gibt Ihnen Hinweise und
Tipps, die Ihnen die Arbeit mit dem
Integration Kit erleichtern.

Dieses Symbol weist Sie auf Stellen im
Handbuch hin, an denen Sie weiterführende
Informationen finden.

Dieses Symbol warnt Sie vor Gefahren, die
zu Personenschäden oder Sachschäden
führen können.

1.6 Gewährleistung

Einschränkung der
Gewährleistung

Einleitung - 11 -

Wir behalten uns inhaltliche Änderungen der Dokumentation und
der Software ohne Ankündigung vor. Die NAVIGON GmbH
übernimmt keine Haftung für die Richtigkeit des Inhalts oder für
Schäden, die sich aus dem Gebrauch des Handbuchs ergeben.

Wir sind jederzeit dankbar für Hinweise auf Fehler oder für
Verbesserungsvorschläge, um Ihnen in Zukunft noch
leistungsfähigere Produkte anbieten zu können.

Anwenderhandbuch NAVIGON Integration Kit 4.0

1.6.1 Support

Sie benötigen Hilfe? Unsere Servicemitarbeiter sind montags bis freitags von 9:00 Uhr

bis 18:00 Uhr telefonisch für Sie da. Sie erreichen unsere Hotline
für Deutschland, Österreich und die Schweiz unter der Rufnummer

Kundenhotline (dtms-Service, 0,12 €/min):
0049-(0)180-5-NAVIKIT (0049-(0)180-5-6284548)

Fax-Hotline (dtms-Service, 0,12 €/min):
0049-(0)180-5-6284444

Daneben finden Sie auf den Internet-Seiten der NAVIGON GmbH
unter http://www.navigon.com im Bereich Support unter FAQ
Listen, die Antworten auf häufig gestellte Fragen bereitstellen.

1.7 Warenzeichen

Geschützte
Warenzeichen

 Outlook, Windows, Access, Excel, SQL Server, Visual Studio,

Alle innerhalb des Handbuchs genannten und ggf. durch Dritte
geschützten Marken- und Warenzeichen unterliegen unein­geschränkt den Bestimmungen des jeweils gültigen Kennzeichen­rechts und den Besitzrechten der jeweiligen eingetragenen
Eigentümer. Alle hier bezeichneten Warenzeichen, Handelsnamen
oder Firmennamen sind oder können Warenzeichen oder
eingetragene Warenzeichen ihrer jeweiligen Eigentümer sein. Alle
Rechte, die hier nicht ausdrücklich gewährt werden sind
vorbehalten.

Aus dem Fehlen einer expliziten Kennzeichnung der in diesem
Handbuch verwendeten Warenzeichen kann nicht geschlossen
werden, dass ein Name von den Rechten Dritter frei ist.

Visual Basic, eMbedded Visual C++ und ActiveSync sind
Warenzeichen der Microsoft Corporation

- 12 - Warenzeichen

Anwenderhandbuch NAVIGON Integration Kit 4.0

2 Programmierschnittstellen

In diesem Kapitel finden Sie Informationen zu den folgenden Themen:

2.1 Voraussetzungen der Entwicklungsumgebung Seite 14

2.2 Schnittstelle IMNNIK Seite 15

2.3 Schnittstelle IADDRESS Seite 19

2.4 Schnittstelle IROUTING Seite 34

2.5 Schnittstelle IPOSITION Seite 52

2.6 Schnittstelle INAVIGATION Seite 64

2.7 Schnittstelle IOPTIONS Seite 89

2.8 Schnittstelle IGPS Seite 106

2.9 Schnittstelle ITMC Seite 114

2.10 Schnittstelle ILOCATIONMAP Seite 124

2.11 Schnittstelle ITRACK Seite 136

2.12 Schnittstelle ISIMULATION Seite 141

2.13 Schnittstelle IMNNIKEvents Seite 147

Programmierschnittstellen - 13 -

Anwenderhandbuch NAVIGON Integration Kit 4.0

2.1 Voraussetzungen der Entwicklungsumgebung

Überblick Um die Schnittstellen in eigenen Applikationen anwenden zu

können dienen die Header-Datei NIKxx.h und die
Objektbibliothek NIKxx.TLB als die Programmierschnittstelle.
Diese beiden Dateien müssen bei Einsatz von Microsoft Visual
Studio als Entwicklungsumgebung in das Projekt eingebunden
werden.

Plattform Dateien

MS-Windows 2000
und XP

Header-Datei: NIK32.h
Objektbibliothek: NIK32.TLB
COM-DLL: NIK32.DLL

Windows Mobile
2003

Header-Datei: NIKCE.h
Objektbibliothek: NIKCE.TLB
COM-DLL: NIKCE.DLL

2.1.1 Allgemeines zur Benutzung der Interfaces

Instanziierung der
Interfaces

Freigabe der
Interfaces

Methoden der
Interfaces benutzen

 CoCreateInstance erzeugt eine Instanz von IMNNIK

 QueryInterface erzeugt Instanzen aller anderen Interfaces

 CComObject::CreateInstance erzeugt Instanz von

IMNNIKEvents
AtlAdvise stellt die Verbindung zum NAVIGON Integration

Kit her

Release gibt die Instanzen der Interfaces frei

AtlUnadvise beendet die Verbindung von IMNNIKEvents mit dem

NAVIGON Integration Kit.

Hinweis: Weitere Informationen dazu finden Sie z.B. in der
MSDN (Microsoft Developer Network).

Die meisten Interfaces verfügen über Open- und Close-Methoden,
die entsprechend vor bzw. nach der Ausführung der jeweiligen
Methoden des Interface aufgerufen werden müssen

- 14 - Voraussetzungen der Entwicklungsumgebung

2.1.2 Schnittstellen im Überblick

Anwenderhandbuch NAVIGON Integration Kit 4.0

Verfügbare
Schnittstellen

 IMNNIK (Default-Interface), siehe Seite 15

Die folgenden Schnittstellen stehen Ihnen im NAVIGON
Integration Kit zur Verfügung:

 IADDRESS, siehe Seite 19

 IROUTING, siehe Seite 34
 IPOSITION, siehe Seite 52
 INAVIGATION, siehe Seite 59

 IOPTIONS, siehe Seite 89
 IGPS, siehe Seite 106
 ITMC, siehe Seite 114
 ILOCATIONMAP, siehe Seite 124

 ITRACK, siehe Seite 136
 ISIMULATION, siehe Seite 141
 IMNNIKEvents, siehe Seite 141

2.2 Schnittstelle IMNNIK

Überblick

Typische
Verwendung

Methoden

 Methode MNOpen(), siehe Seite 16

Die Programmierschnittstelle IMMNIK wird zum Starten und
Beenden der Navigationssoftware verwendet.

Das Integration Kit muss zu Beginn einer Applikation geöffnet
und bei deren Beendigung geschlossen werden. Ein Öffnen
während einer gestarteten Applikation ist nicht empfehlenswert.

Hinweis: Stellen Sie sicher, dass die Methode MNOpen()
abgeschlossen ist, bevor Sie andere Methoden (ausgenommen
der Methoden GetMNOpen() und GetMNVersion() s.u.) dieser
oder anderer Programmierschnittstellen aufrufen.

MNOpen();

// Andere Schnittstellen|Methoden

MNClose();

In der Schnittstelle IMNNIK stehen Ihnen die folgenden Methoden
zur Verfügung:

 Methode MNClose(), siehe Seite 16
 Methode GetMNOpen(), siehe Seite 17
 Methode GetMNVersion(), siehe Seite 17

Programmierschnittstellen - 15 -

2.2.1 Methode MNOpen()

Anwenderhandbuch NAVIGON Integration Kit 4.0

Beschreibung

Die Methode MNOpen() startet die Navigationssoftware als
Hintergrundprozess. Dabei wird eine grundlegende Initialisierung
durchgeführt, die das NIK für alle weiteren Interfaces vorbereitet.

C++ Syntax

IMNNIK::MNOpen

Typ

HRESULT MNOpen()

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

Anmerkungen Da die Navigationssoftware einige Zeit zum Initialisieren und

Starten benötigt, sollte eine entsprechende Wartezeit
eingebunden werden, bis Methoden anderer Schnittstellen
aufgerufen werden. Sie können die aktuelle Startdauer mit der
Methode GetMNOpen() (siehe Seite 17) abfragen und so
herausfinden, wann die Navigationssoftware komplett gestartet
wurde.

Die Methode erkennt, ob eine andere Instanz der Navigations­software bereits ausgeführt wird und schließt diese.

Achtung: Rufen Sie keine andere Methode auf, bevor MNOpen()
nicht abgeschlossen ist.

2.2.2 Methode MNClose()

Beschreibung

C++ Syntax

Typ

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Die Methode MNClose() beendet die Navigationssoftware.

IMNNIK::MNClose

HRESULT MNClose()

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

- 16 - Schnittstelle IMNNIK

2.2.3 Methode GetMNOpen()

Anwenderhandbuch NAVIGON Integration Kit 4.0

Beschreibung

Die Methode GetMNOpen() liefert den aktuellen Startvorgang der
Navigationssoftware zurück.

C++ Syntax

IMNNIK::GetMNOpen

Typ

HRESULT GetMNOpen([out] BOOL * a_open )

Parameter Die folgenden Parameter können mit der Methode verwendet

werden:

Parameter Bedeutung

a_open

Zeiger auf eine BOOL Variable, die den
Status enthält. Ist dieser Parameter TRUE, so
ist das NIK erfolgreich geöffnet. Ist dieser
Parameter FALSE, so ist das NIK noch nicht
geöffnet, sondern befindet sich
möglicherweise noch in der Initialisierung.

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

2.2.4 Methode GetMNVersion()

Beschreibung

C++ Syntax

Typ

Parameter Die folgenden Parameter können mit der Methode verwendet

Die Methode GetMNOpen() liefert den aktuellen Startvorgang der
Navigationssoftware zurück.

IMNNIK::GetMNVersion

HRESULT GetMNVersion(

[out] int * a_rnMajor,

[out] int * a_rnMinor,

[out] int * a_rnBuild )

werden:

Parameter Bedeutung

a_rnMajor

Zeiger auf eine int Variable, die die
Hauptversionsnummer enthält.

a_rnMinor

Zeiger auf eine int Variable, die die
Unterversionsnummer enthält.

a_rnBuild

Zeiger auf eine int Variable, die die Build­Nummer enthält.

Programmierschnittstellen - 17 -

Anwenderhandbuch NAVIGON Integration Kit 4.0

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

2.2.5 Öffnen und schließen des NIK

Beispiel

/* erzeuge eine Instanz des Default-Interface IMNNIK */

CoCreateInstance( __uuidof(MNNIK), NULL,
CLSCTX_INPROC_SERVER,__uuidof(IMNNIK),
(void**)&m_NIK );

/* Öffnen des NIK */

m_NIK->MNOpen();

/* Warte bis das NIK erfolgreich geöffnet wurde */

while( !bOpen )

m_NIK->GetMNOpen( &bOpen );

/* Schließen des NIK */

m_NIK->MNClose();

- 18 - Schnittstelle IMNNIK

2.3 Schnittstelle IADDRESS

Anwenderhandbuch NAVIGON Integration Kit 4.0

Überblick

Funktionsumfang  Zugriff auf Adressen und POI der verwendeten Karte

Typische
Verwendung

Methoden

Die Programmierschnittstelle IADDRESS ermöglicht den Zugriff auf
Städte, Straßen, POI im verwendeten Kartenmaterial. Sie können
mit dieser Schnittstelle Koordinaten für das Routing oder die
Navigation ermitteln.

 Suche nach Städten, Straßen und POI (z.B. alle Tankstellen in

einer Stadt)

 Ermittlung der Koordinaten zu einer Adresse oder eines POI
 Ermittlung der Identifikation in der Karte zu einer Adresse

oder POI

 Ermittlung der Adresse zu einer Koordinate

Hinweis: Koordinaten werden immer im Format WGS-84
geliefert.

OpenAddress();

// Andere Methoden von IADDRESS

CloseAddress();

In der Schnittstelle IADDRESS stehen Ihnen die folgenden
Methoden zur Verfügung:

 Methode OpenAddress(), siehe Seite 20

 Methode CloseAdress(), siehe Seite 20
 Methode SearchFirstCityAddress(), siehe Seite 21

 Methode SearchFirstCityPostalCodeAddress, siehe Seite 22
 Methode SearchNextCityAddress(), siehe Seite 23
 Methode SearchFirstStreetAddress(), siehe Seite 25

 Methode SearchNextStreetAddress(), siehe Seite 26
 Methode SearchPoiByRadiusAddress(), siehe Seite 28
 Methode SearchNextPoiAddress(), siehe Seite 29
 Methode ConvertCoordInAddress(), siehe Seite 30

 Methode ConvertCoordInAddress2(), siehe Seite 32
 Methode ConvertCoordInCountry(), siehe Seite 33

Programmierschnittstellen - 19 -

2.3.1 Methode OpenAddress()

Anwenderhandbuch NAVIGON Integration Kit 4.0

Beschreibung

Die Schnittstelle IADDRESS wird mit der Methode OpenAddress()
gestartet.

C++ Syntax

IADDRESS::OpenAddress

Typ

HRESULT OpenAddress()

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

2.3.2 Methode CloseAdress()

Beschreibung

C++ Syntax

Typ

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Die Methode CloseAddress() schließt das Interface. Nach dieser
Methode können keine weiteren Methoden des Interfaces mehr
aufgerufen werden.

IADDRESS::CloseAddress

HRESULT CloseAddress()

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

- 20 - Schnittstelle IADDRESS

Anwenderhandbuch NAVIGON Integration Kit 4.0

2.3.3 Methode SearchFirstCityAddress()

Beschreibung

Die Methode SearchFirstCityAddress() wird bei der Suche
nach einer Stadt zuerst aufgerufen. Die Länderkennzeichen und
das Präfix des Stadtnames initialisieren die Suche. Anschließend
können durch wiederholtes Aufrufen der Methode
SearchNextCityAddress() (siehe Seite 23) , alle weiteren
Städte gefunden werden, die dem Muster aus Länderkennzeichen
und Präfix des Stadtnamens entsprechen.

C++ Syntax

IADDRESS::SearchFirstCityAddress

Typ

HRESULT SearchFirstCityAddress(

[in] int a_country,

[in] BSTR prefix,

[out] BSTR * city,

[out] BSTR * plz,

[out] long * a_id,

[out] BOOL * a_find,

[out] double * a_latx,

[out] double * a_longy )

Parameter Die folgenden Parameter können mit der Methode verwendet

werden:

Parameter Bedeutung

a_country

Spezifiziert das Länderkennzeichen des
Landes, in dem die Stadt gesucht werden
soll, z.B. DEU für Deutschland, FRA für
Frankreich (siehe Aufzählungstypen auf
Seite 166).

prefix

Spezifiziert das Präfix der Stadt, nach der
gesucht werden soll.

city

Zeiger auf eine BSTR Variable, die den
Stadtnamen für die gefundene Stadt enthält.

plz

Zeiger auf eine BSTR Variable, die die
Postleitzahl für die gefundene Stadt enthält.

a_id

Zeiger auf eine long Variable, die die
Identifikationsnummer der gefundenen Stadt
enthält (Stadt-Id).

a_find Zeiger auf eine BOOL Variable die angibt, ob

eine Stadt gefunden wurde. Ist der Wert
TRUE, so wurde eine Stadt gefunden,
andernfalls wurde keine Stadt gefunden.

a_latx

Zeiger auf eine double Variable die den
Breitengrad der gefundenen Stadt im Format
WGS-84 enthält.

a_longy

Zeiger auf eine double Variable die den
Längengrad der gefundenen Stadt im Format
WGS-84 enthält.

Programmierschnittstellen - 21 -

Anwenderhandbuch NAVIGON Integration Kit 4.0

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

Beispiel

m_NIK_Address->OpenAddress();

/* Suche erste Stadt */

m_NIK_Address->SearchFirstCityAddress( DEU, “Frankf“,
&bstrCity, &bstrPlz, &nCityId,
&bFoundMore, &dLatX, &dLongY);

m_NIK_Address->CloseAddress();

2.3.4 Methode SearchFirstCityPostalCodeAddress()

Beschreibung

Die Methode SearchFirstCityPostalCodeAddress() wird bei
der Suche nach einer Stadt zuerst aufgerufen. Die
Länderkennzeichen und das Präfix der Postleitzahl initialisieren
die Suche. Anschließend können durch ein wiederholtes Aufrufen
der Methode SearchNextCityAddress() (siehe Seite 23), alle
weiteren Städte gefunden werden, die dem Muster aus
Länderkennzeichen und Präfix der Postleitzahl entsprechen.

C++ Syntax

IADDRESS::SearchFirstCityPostalCodeAddress

Typ

HRESULT SearchFirstCityPostalCodeAddress(

[in] int a_country,

[in] BSTR prefix_postalcode,

[out] BSTR * city,

[out] BSTR * postalcode,

[out] long * a_id,

[out] BOOL * a_find,

[out] double * a_latx,

[out] double * a_longy )

Parameter Die folgenden Parameter können mit der Methode verwendet

werden:

Parameter Bedeutung

a_country

Spezifiziert das Länderkennzeichen des
Landes, in dem die Stadt gesucht werden
soll, z.B. DEU für Deutschland, FRA für
Frankreich (siehe Aufzählungstypen auf Seite

166).

- 22 - Schnittstelle IADDRESS

Anwenderhandbuch NAVIGON Integration Kit 4.0

Parameter Bedeutung

prefix_
postalcode

city

Spezifiziert das Präfix der Postleitzahl, nach
der gesucht werden soll.

Zeiger auf eine BSTR Variable, die den
Stadtnamen für die gefundene Stadt enthält.

postalcode

Zeiger auf eine BSTR Variable, die die
Postleitzahl für die gefundene Stadt enthält.

a_id

Zeiger auf eine long Variable, die die
Identifikationsnummer der gefundenen Stadt
enthält (Stadt-Id).

a_find

Zeiger auf eine BOOL Variable die angibt, ob
eine Stadt gefunden wurde. Ist der Wert
TRUE, so wurde eine Stadt gefunden,
andernfalls wurde keine Stadt gefunden.

a_latx

Zeiger auf eine double Variable die den
Breitengrad der gefundenen Stadt im Format
WGS-84 enthält.

a_longy

Zeiger auf eine double Variable die den
Längengrad der gefundenen Stadt im Format
WGS-84 enthält.

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

Anmerkungen

Wird mit der Methode SearchFirstCityPostalCodeAddress()
eine Stadt gefunden (a_find ist TRUE), dann können mit der
Methode SearchNextCityAddress() alle weiteren Städte
gefunden werden.

2.3.5 Methode SearchNextCityAddress()

Beschreibung

C++ Syntax

Typ

Programmierschnittstellen - 23 -

Die Methode SearchNextCityAddress() wird zur Suche nach
weiteren Städten verwendet. Vorher muss durch den Aufruf von

SearchFirstCityAddress() oder SearchFirstCityPostal­CodeAddress() die Suche nach Städten eingeleitet worden sein.

IADDRESS::SearchNextCityAddress

HRESULT SearchNextCityAddress (

[out] BSTR * city,

[out] BSTR * plz,

[out] long * a_id,

[out] BOOL * a_find,

[out] double * a_latx,

[out] double * a_longy )

Anwenderhandbuch NAVIGON Integration Kit 4.0

Parameter Die folgenden Parameter können mit der Methode verwendet

werden:

Parameter Bedeutung

city

Zeiger auf eine BSTR Variable, die den
Stadtnamen für die gefundene Stadt enthält.

plz

Zeiger auf eine BSTR Variable, die die
Postleitzahl für die gefundene Stadt enthält.

a_id

Zeiger auf eine long Variable, die die
Identifikationsnummer der gefundenen Stadt
enthält (Stadt-Id).

a_find

Zeiger auf eine BOOL Variable die angibt, ob
eine Stadt gefunden wurde. Ist der Wert
TRUE, so wurde eine Stadt gefunden,
andernfalls wurde keine Stadt gefunden.

a_latx

Zeiger auf eine double Variable die den
Breitengrad der gefundenen Stadt im Format
WGS-84 enthält.

a_longy

Zeiger auf eine double Variable die den
Längengrad der gefundenen Stadt im Format
WGS-84 enthält.

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

Beispiel

m_NIK_Address->OpenAddress();

/* suche erste Stadt */

m_NIK_Address->SearchFirstCityAddress( DEU, “Frankf“,
&bstrCity, &bstrPlz, &nCityId,
&bFoundMore, &dLatX, &dLongY );

/* suche nach weiteren Städten */

while( bFoundMore )

m_NIK_Address->SearchNextCityAddress( &bstrCity,
&bstrPlz, &nCityId, &bFoundMore,
&dLatX, &dLongY );

m_NIK_Address->CloseAddress();

- 24 - Schnittstelle IADDRESS

Anwenderhandbuch NAVIGON Integration Kit 4.0

2.3.6 Methode SearchFirstStreetAddress()

Beschreibung

C++ Syntax

Typ

Die Methode SearchFirstStreetAddress() muss bei der Suche
nach einer Straße oder einem POI als erstes aufgerufen werden.
Die Stadt-Id und das Präfix für den Straßen- oder POI-Namen
initialisieren die Suche. Anschließend können durch wiederholtes
Aufrufen der Methode SearchNextStreetAddress() alle weiteren
Straßen oder POI gefunden werden, die dem Muster aus Stadt-Id
und Präfix des Straßen- oder POI-Namens entsprechen.

IADDRESS:: SearchFirstStreetAddress

HRESULT SearchFirstStreetAddress (

[in] long id_city,

[in] BSTR prefix,

[in] int type_from,

[in] int type_to,

[in] BSTR hn,

[out] BSTR * street,

[out] BSTR * plz,

[out] long * a_id,

[out] BOOL * a_find,

[out] double * a_latx,

[out] double * a_longy )

Parameter Die folgenden Parameter können mit der Methode verwendet

werden:

Parameter Bedeutung

id_city

Spezifiziert die Identifikationsnummer der
Stadt (Stadt-Id).

refix

Spezifiziert das Präfix der Straße oder POI,
nach denen gesucht werden soll.

type_from

Legt für die Einschränkung der POI-Kategorie
das Minimum fest (siehe GeoTypeId).

type_to

Legt die maximale POI-Kategorie fest.
type_to ist der erste POI der aus der Reihe
ausgeschlossen wird. Z. Bsp. alle Tankstellen
finden:

type_from = enPetrolStation
type_to = enRentACar

hn

Legt die Hausnummer fest, nach der in der
Strasse gesucht werden soll.

street

Zeiger auf eine BSTR Variable, die den
Straßennamen für das die gefundene Strasse
enthält.

plz

Zeiger auf eine BSTR Variable, die die
Postleitzahl für die gefundene Straße enthält.

Programmierschnittstellen - 25 -

Anwenderhandbuch NAVIGON Integration Kit 4.0

Parameter Bedeutung

a_id

Zeiger auf eine long Variable, die die
Identifikationsnummer der gefundenen
Straße enthält (Straßen-Id).

a_find

Zeiger auf eine BOOL Variable die angibt, ob
eine Strasse gefunden wurde. Ist der Wert
TRUE, so wurde eine Strasse gefunden,
andernfalls wurde keine Strasse gefunden.

a_latx

Zeiger auf eine double Variable die den
Breitengrad der gefundenen Strasse im
Format WGS-84 enthält.

a_longy

Zeiger auf eine double Variable die den
Längengrad der gefundenen Strasse im
Format WGS-84 enthält.

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

Beispiel

m_NIK_Address->OpenAddress();

/* suche erste Straße für Stadt nCityId */

m_NIK_Address->SearchFirstStreetAddress( nCityId,
“Bahn“,enAllTypes, enAllTypes, NULL,
&bstrStreet, &bstrPlz, &nStreetId,
&bFoundMore, &dLatX, &dLongY );

m_NIK_Address->CloseAddress();

2.3.7 Methode SearchNextStreetAddress()

Beschreibung

C++ Syntax

Typ

Die Methode SearchNextStreetAddress() wird zur Suche nach
weiteren Straßen verwendet. Vorher muss durch Aufruf von
SearchFirstStreetAddress() die Suche nach Straßen
eingeleitet worden sein.

IADDRESS::SearchNextStreetAddress

HRESULT SearchNextStreetAddress (

[out] BSTR * street,

[out] BSTR * plz,

[out] long * a_id,

[out] BOOL * a_find,

[out] double * a_latx,

[out] double * a_longy )

- 26 - Schnittstelle IADDRESS

Anwenderhandbuch NAVIGON Integration Kit 4.0

Parameter Die folgenden Parameter können mit der Methode verwendet

werden:

Parameter Bedeutung

street

Zeiger auf eine BSTR Variable, die den
Straßennamen für das die gefundene Strasse
enthält.

plz

Zeiger auf eine BSTR Variable, die die
Postleitzahl für die gefundene Straße enthält.

a_id

Zeiger auf eine long Variable, die die
Identifikationsnummer der gefundenen
Straße enthält (Straßen-Id).

a_find

Zeiger auf eine BOOL Variable die angibt, ob
eine Strasse gefunden wurde. Ist der Wert
TRUE, so wurde eine Strasse gefunden,
andernfalls wurde keine Strasse gefunden.

a_latx

Zeiger auf eine double Variable die den
Breitengrad der gefundenen Strasse im
Format WGS-84 enthält.

a_longy

Zeiger auf eine double Variable die den
Längengrad der gefundenen Strasse im
Format WGS-84 enthält.

Rückgabewerte Die Methode liefert die folgenden Rückgabewerte:

Rückgabewerte Bedeutung

S_OK

S_FALSE

Erfolg

Misserfolg

Beispiel: Suche nach
Straßen

m_NIK_Address->OpenAddress();

/* suche erste Straße für Stadt nCityId */

m_NIK_Address->SearchFirstStreetAddress( nCityId,
“Bahn“,enAllTypes, enAllTypes, NULL,
&bstrStreet, &bstrPlz, &nStreetId,
&bFoundMore, &dLatX, &dLongY );

/* suche nach weiteren Straßen */

while( bFoundMore )

m_NIK_Address->SearchNextStreetAddress( &bstrStreet,
&bstrPlz,&nStreetId,&bFoundMore, &dLatX, &dLongY );

m_NIK_Address->CloseAddress();

Programmierschnittstellen - 27 -

Anwenderhandbuch NAVIGON Integration Kit 4.0

Beispiel: Suche nach
POIs

m_NIK_Address->OpenAddress();

/* suche erste Tankstelle für Stadt nCityId */

m_NIK_Address->SearchFirstStreetAddress( nCityId, ““,
enPetrolStation, enPetrolStation+1,
NULL,&bstrStreet, &bstrPlz, &nPoiId,
&bFoundMore, &dLatX, &dLongY );

/* suche nach weiteren Tankstellen */

while( bFoundMore )

m_NIK_Address->SearchNextStreetAddress( &bstrStreet,
&bstrPlz,&nPoiId,&bFoundMore, &dLatX, &dLongY );

m_NIK_Address->CloseAddress();

2.3.8 Methode SearchPoiByRadiusAddress()

Beschreibung

C++ Syntax

Typ

Die Methode SearchPoiByRadiusAddress() muss bei der
Umkreissuche nach POI als erstes aufgerufen werden. Das Präfix
für den POI-Namen und ein Mittelpunkt initialisieren die Suche.
Anschließend können durch ein wiederholtes Aufrufen der
Methode SearchNextPoiAddress() alle POI gefunden werden,
die sich im Umkreis befinden und dem Muster des POI-Namens
entsprechen.

IADDRESS::SearchPoiByRadiusAddress

HRESULT SearchPoiByRadiusAddress(

[in] BSTR prefix,

[in] double a_lat,

[in] double a_long,

[in] int a_radius,

[in] int type_from,

[in] int type_to,

[out] BOOL * a_find )

Parameter Die folgenden Parameter können mit der Methode verwendet

werden:

Parameter Bedeutung

prefix

Spezifiziert das Präfix des POI-Namens, nach
dem gesucht werden soll.

a_lat

Spezifiziert den Breitengrad des
Mittelpunktes im Format WGS-84.

a_long

Spezifiziert den Längengrad des
Mittelpunktes im Format WGS-84.

a_radius

Spezifiziert den Radius in Meter für den
Umkreis.

type_from

Legt für die Einschränkung der POI-Kategorie
das Minimum fest.

- 28 - Schnittstelle IADDRESS