Map24 Administrators Guide

Map24
Administrators Guide
Stand: 21 September 2000
1 Inhaltsverzeichnis
1
Inhaltsverzeichnis ........................................................................................ 1
2
Einleitung...................................................................................................... 2
2.1
Technische Voraussetzungen ..................................................................... 2
2.2
Ansprechen des Map24-Server................................................................... 2
2.3
Produkte ................................................................................................. 2
3
Link2Map24 .................................................................................................. 3
3.4
Code-Generator ....................................................................................... 3
3.5
Locations darstellen.................................................................................. 3
3.5.1 Basis-URL ............................................................................................ 3
3.5.2 Allgemeine Parameter ........................................................................... 3
3.5.3 Übergabe von Locations......................................................................... 4
3.5.4 Beispiele.............................................................................................. 4
3.6
Route berechnen...................................................................................... 4
4
Map24-Bitmap-Mapping ................................................................................ 4
4.1
Basis-URL................................................................................................ 4
4.2
Absolute Koordinaten................................................................................ 5
4.3
Das Session-Konzept ................................................................................ 5
4.4
Relative Navigation................................................................................... 5
4.5
Vordefinierte Locations ............................................................................. 6
4.6
Darstellen von Locations zur Laufzeit .......................................................... 6
4.7
Weitere Parameter ................................................................................... 7
4.8
Map24-CGI Info-Service............................................................................ 7
5
Maplets - Interaktives Mapping..................................................................... 8
5.1
Applet-Tag .............................................................................................. 8
5.1.1 Basis-Tag............................................................................................. 8
5.1.2 Applet-Parameter.................................................................................. 8
5.1.3 Beispiel.............................................................................................. 10
5.2
Administrationsmodus ............................................................................ 10
5.2.1 Kartenausschnitt bestimmen ................................................................ 11
5.2.2 Position einer Location speichern .......................................................... 11
5.3
MRC – Maplet Remote Control.................................................................. 11
5.3.1 Was ist MRC? ..................................................................................... 11
5.3.2 Funktionsprinzip ................................................................................. 11
5.3.3 Parameter.......................................................................................... 11
6
Routing ....................................................................................................... 15
6.1
Basis-URL.............................................................................................. 15
6.2
Parameter ............................................................................................. 16
6.2.1 Erzeugen einer Routing ID ................................................................... 16
6.2.2 Berechnung der Wegbeschreibung ........................................................ 17
Einleitung
Seite 1
2 Einleitung
Dieses Dokument vermittelt eine technische Übersicht über die Einsatzmöglichkeiten von
Map24 und seinen Komponenten. Diese sind:
•
•
•
•
Bitmap-Karten
Maplets (interaktive Java-Karten)
GeoMatcher (hausnummerngenau)
Routenberechnung
2.1 Technische Voraussetzungen
Auf Kundenseite werden keinerlei technische Voraussetzungen benötigt. Die komplette
Funktionalität von Map24 wird über HTML-Tags direkt in die eigene Internetpräsenz
eingebunden.
Zur Identifizierung des eigenen Map24-Dienstes wird eine Map24-ID benötigt. Um
Missbrauch mit dieser Map24-ID vorzubeugen (z.B. Integration des Mapping auf fremden
Homepages mit Ihrer ID), lesen Sie bitte das Kapitel 8.6 ().
2.2 Ansprechen des Map24-Server
Der Map24-Kartenserver ist unter dem Namen
maptp.map24.com
erreichbar.
2.3 Produkte
Map24 definiert 4 Produkte, mit der Sie als Kunde Mapping-Dienste auf Ihrer eigenen
Homepage integrieren können:
Produkt
Beschreibung
Kosten
link2Map24
Einbindung von Adressenanzeige, Adressensuche und kostenlos
Routenberechnung über Verlinkung für Internetportale,
Unternehmen und Privatpersonen.
freeMap24
für private Homepages
kostenlos
businessMap24 für Unternehmens-Websites
kostenpflichtig
portalMap24
kostenpflichtig
für Internetportale und Informationsdienste
In Abschnitt 3 wird eine technische Beschreibung für das Produkt link2Map24 gegeben,
welches durch Verlinkung auf die Map24-Homepage die Mapping-Funktionalität auf Ihrer
Homepage zur Verfügung stellt.
Ab Abschnitt 4 wird eine technische Beschreibung der Funktionalitäten zur Einbindung in
die eigenen Seiten gegeben. Diese Beschreibung ist für die Produkte freeMap24,
businessMap24 und pootalMap24 gültig.
Einleitung
Seite 2
3 Link2Map24
In diesem Abschnitt werden die einzelnen Parameter beschrieben, mit der Sie Map24 aus
Ihrer eigenen WebSite oder aus Ihrer eigenen Software heraus aufrufen können. Um
link2Map24 nutzen zu können müssen Sie sich registriert haben und eine link2Map24ID (LID) erhalten haben. Die LID muss bei jedem Aufruf als Parameter mit übergeben
werden.
Die Registrierung für link2Map24 ist kostenlos.
Sie können sich unter http://www.map24.com/subscription/ kostenlos für link2Map24
registrieren.
3.4 Code-Generator
Der link2Map24-Code-Generator erstellt Ihnen den notwendigen HTML-Code zum
Verlinken auf Map24 ganz automatisch. Halten Sie Ihre link2Map24-ID bereit und
probieren Sie den Code-Generator aus:
http://www.map24.com/mymap24/link2map24.php3
3.5 Locations darstellen
3.5.1 Basis-URL
Die Basis-URL für link2Map24 lautet:
http://link2.map24.com/?lid=<LID>
3.5.2 Allgemeine Parameter
Parameter
Typ
Beschreibung
lid
STRING
Bei der Registrierung bekommen Sie eine eindeutige LinkID zugewiesen.
maptype
STRING
= CGI
= CGIJS
= JAVA
es wird die Bitmap-Version der Map24-Seite
aufgerufen (default).
es wird die Bitmap-Version mit JavaScriptUnterstützung aufgerufen.
es wird die vollständig interaktive JavaVersion aufgerufen.
Auf der Map24-Seite kann man jederzeit zwischen den drei
Versionen umschalten.
Width
Link2Map24
Numeric
(Integer)
Die Breite des ersten Kartenausschnittes in Metern.
Seite 3
3.5.3 Übergabe von Locations
Der Map24-Seite können beliebig viele Locations als Parameter übergeben werden,
entweder mit Koordinaten oder mit Adressinformationen, die zur Laufzeit geocodiert
werden. Die Locations müssen lückenlos von 0 anfangend durchnumeriert werden. Im
folgenden bezeichnet im Parameter die Location-Nummer, von 0 anfangend.
Parameter
Typ
Beschreibung
locid<x>
STRING
Eine beliebige, für diese Session gültige Location-ID. Mit dieser ID kann
in späteren Aufrufen der Kartenausschnitt wieder direkt zu dieser
Location bewegt werden.
description<x>
STRING
Ein Beschreibungstext, der an der Location dargestellt wird.
url<x>
STRING
Die URL, zu der gesprungen wird, falls auf die Location geklickt wird (wird
momentan in den Bitmap-Karten noch nicht unterstützt, sondern lediglich
in den Maplets. In zukünftigen Versionen wird es möglich sein, zu
Bitmap-Karten auch ensprechende Image-Maps zu generieren).
Numeric
(Integer)
Eine Symbol-ID aus der Map24-Symbol-Bibliothek. Das Symbol wird
angezeigt, falls keine Logo-URL definiert wurde oder falls der Zoomlevel
ist zu groß um ein Logo darzustellen. Falls keine Symbol-ID spezifiziert
wurde, wird ein Standard-Symbol gewählt. Die vorhandenen Symbole
sind unter folgender URL verzeichnet:
sym<x>
http://www.map24.com/mymap24/symbols.php3
die Position der Location wird durch Angabe einer vollständigen Adresse durch den eingebauten Geocodierer
ermittelt...
street<x>
STRING
Straße der darzustellenden Adresse.
zip<x>
STRING
Postleitzahl der darzustellenden Adresse.
city<x>
STRING
Ortsname der darzustellenden Adresse.
...oder durch direkte Angabe von Koordinaten
wx<x>
wy<x>
Numeric
(float)
Position der Location in Weltkoordinaten (Angabe in Minuten).
3.5.4 Beispiele
Standort der NETSOLUT GmbH in einer Bitmap-Karte:
http://link2.map24.com/?lid=asdf&maptype=CGIJS&street0=Falkensteiner+Str.+7
7&zip0=60322&city0=Frankfurt&description0=NETSOLUT+GmbH
Standort der NETSOLUT GmbH in interaktiver Java-Karte mit Logo darstellen:
http://link2.map24.com/?lid=asdf&maptype=JAVA&street0=Falkensteiner+Str.+77
&zip0=60322&city0=Frankfurt.&description0=NETSOLUT+GmbH
3.6 Route berechnen
Die Funktion „Route berechnen“ist in Kürze verfügbar.
4 Map24-Bitmap-Mapping
Map24-Bitmaps können einfach über Image-Tags in HTML-Seiten eingebunden werden.
4.1 Basis-URL
Die Basis-URL der Map24-Bitmaps lautet:
Map24-Bitmap-Mapping
Seite 4
http://maptp.map24.com/map24/cgi?mid=<Map24 -ID>
Die Map24-ID identifiziert den Map24-Kunden. Jeder Aufruf muß diese ID enthalten,
sonst wird keine gültige Karte zurückgeliefert. Außerdem enthält ein Aufruf weitere
Parameter, die in den folgenden Abschnitten definiert werden.
4.2 Absolute Koordinaten
Ein Kartenausschnitt kann durch die Angabe von einem Koordinatenpaar (X/Y) und einer
Ausschnittsbreite in Metern definiert werden. Die Koordinaten werden als
Weltkoordinaten in Minuten angeben (siehe Kapitel 10).
Parameter
Typ
Beschreibung
wx
wy
Numeric
(float)
Weltkoordinaten des Mittelpunktes des neuen Kartenausschnittes in Minuten.
Dezimaltrennzeichen ist der Punkt (.).
width
Numeric
(integer)
Die Breite des Kartenausschnittes in Metern.
Beispiel:
Kartenausschnitt von Frankfurt/Main mit einer Ausschnittsbreite von 5 km:
<img src=“http://maptp.map24.com/map24/cgi?mid=MAP24&
wx=520.546330921319&wy=3007.9021226760296&width=5000“>
Durch entsprechende Navigationselemente in der HTML-Seite und durch die Berechnung
von Koordinaten und Ausschnittsbreite läßt sich eine Navigation mit Map24-Bitmaps
leicht in dynamischen HTML-Seiten einbauen.
4.3 Das Session-Konzept
Die Angabe einer Session-ID erzeugt serverseitig eine Benutzersession, die sich neben
dem jeweils aktuellen Ausschnitt auch eine Ausschnitts-History, die in dieser Session
erzeugten Locations sowie berechnete Routen merkt. Somit ist es möglich, auch eine
relative Navigation (durch Angabe von Positionierungsdirektiven wie z.B. „Gehe nach
Norden“ oder „Zoom-In“) über Map24-Bitmaps durchzuführen, ohne das bereits einmal
definierte Locations oder Routen „verlorengehen“.
Parameter
sid
Typ
Beschreibung
Alphanumeric Eine für die
(String)
Zeichenkette).
gegebene
Map24-ID
eindeutige
Session-ID
(beliebige
Achtung:
Die Session-IDs müssen pro Map24-ID eindeutig vergeben werden.
4.4 Relative Navigation
Die relative Navigation berechnet einen neuen Kartenausschnitt durch
bestimmter Positionierungsdirektiven relativ zum vorherigen Ausschnitt.
Parameter
nav
Typ
Beschreibung
STRING
=
=
=
=
=
=
=
Map24-Bitmap-Mapping
NORTHWEST
NORTH
NORTHEAST
EAST
SOUTHEAST
SOUTH
SOUTHWEST
(bewegt den
(... Richtung
(... Richtung
(... Richtung
(... Richtung
(... Richtung
(... Richtung
Angabe
Kartenausschnitt Richtung Nord-Westen)
Norden)
Nord-Osten)
Osten)
Süd-Osten)
Süden)
Süd-Westen)
Seite 5
=
=
=
=
zoom
px
py
WEST
HOME
BACK
FORWARD
(... Richtung Westen)
(kehrt zur Ausgangsposition zurück)
(Eine Stufe zurück in der History der Kartenausschnitte)
(Eine Stufe vor in der History der Kartenausschnitte)
STRING
= IN
(zoom in)
= OUT (zoom out)
= <x> (<x> ist ein Wert zwischen 0 und 100 und gibt einen prozentualen
Zoomwert an)
Numeric
(Integer)
Pixel-Koordinaten, die durch Klicken auf eine Map24-Bitmap-Karte ermittelt
wurden (z.B. wenn die Map24-Bitmap ein Feld eines HTML-Formulars ist). Der
angeklickte Punkt auf der Karte wird der Mittelpunkt des neuen
Kartenausschnittes. In Verbindung mit dem Parameter “zoom” kann
gleichzeitig in die Karte rein- oder rausgezoomt werden. Eine Verbindung mit
dem Parameter “nav”ist nicht möglich.
Achtung:
Für die Benutzung dieser relativen Navigationsbefehle ist die Angabe einer Session-ID
(siehe Abschnitt 4.3) notwendig.
Die Angabe absoluter Koordinaten (siehe Abschnitt 4.2) hat Vorrang vor den hier
vorgestellten relativen Navigationsbefehlen.
4.5 Vordefinierte Locations
Im Administrationsbereich Ihrer Map24-Anwendung (siehe Abschnitt 8) können Sie
beliebige Locations inkl. Beschreibungstext, Logo und Link definieren, die immer in der
Karte erscheinen (auf Straßenebene erscheint das Logo, in höheren Zoomstufen wird das
Logo durch ein frei wählbares Symbol ersetzt). Durch Angabe der Location-ID kann der
Ausschnitt einer Map24-Bitmap ohne Angabe von Koordinaten gewählt werden.
Zusätzlich kann noch die Breite des angezeigten Kartenausschnittes über den Parameter
„width“(s. Abschnitt 4.2) mitbestimmt werden.
Parameter
Locid
Typ
Beschreibung
STRING
Es wird die Position der Location-ID aus der Map24-Datenbank gelesen und
eine Karte mit dieser Location im Mittelpunkt dargestellt. Dieser Parameter
überschreibt die Positions-Parameter wx/wy, Der Parameter width zur
Bestimmung der Ausschnittsbreite kann aber angegeben werden (siehe
Abschnitt 4.2).
4.6 Darstellen von Locations zur Laufzeit
Neben vordefinierten Locations in der Map24-Datenbank lassen sich Locations auch zur
Laufzeit durch flexibel einsetzbare Parameter auf der Karte darstellen.
Es können mehrere Locations pro Aufruf definiert werden. Die Locations müssen
lückenlos bei 0 anfangend durchnumeriert werden.
Falls eine Session-ID spezifiziert wurde (siehe Abschnitt 4.3), werden die so definierten
Locations in der Session gespeichert und bleiben auch bei weiteren Navigationsschritten
in der Karte erhalten.
Im folgenden bezeichnet <x> im Parameter die Location-Nummer pro Aufruf, von 0
anfangend.
Map24-Bitmap-Mapping
Seite 6
Parameter
Typ
Beschreibung
locid<x>
STRING
Eine beliebige, für diese Session gültige Location-ID. Mit dieser ID kann in
späteren Aufrufen der Kartenausschnitt bestimmt werden (siehe Abschnitt
4.5)
description<x>
STRING
Ein einzeiliger Text, der an der Location dargestellt wird.
url<x>
STRING
Die URL, zu der gesprungen wird, falls auf die Location geklickt wird (wird
momentan noch nicht unterstützt. In zukünftigen Versionen wird es möglich
sein, zu Bitmap-Karten auch entsprechende Image-Maps zu generieren).
logo_url<x>
STRING
Die URL des Logos, welches an der Position der Location dargestellt werden
soll.
sym<x>
Numeric
(integer)
Eine Symbol-ID aus der Map24-Symbol-Bibliothek. Das Symbol wird
angezeigt, falls keine Logo-URL definiert wurde oder falls der Zoomlevel zu
groß ist, um ein Logo darzustellen. Falls keine Symbol-ID spezifiziert wurde,
wird ein Standard-Symbol gewählt.
Die Position der Location wird entweder über Koordinaten gegeben...
wx<x>
wy<x>
Numeric
(float)
Position der Location in Weltkoordinaten.
… oder die Position wird durch Angabe einer vollständigen Adresse durch den eingebauten Geocodierer
ermittelt.
street<x>
STRING
Straße der zu geocodierenden Adresse
zip<x>
STRING
Postleitzahl der zu geocodierenden Adresse
city<x>
STRING
Stadt der zu geocodierenden Adresse
country<x>
STRING
Land der zu geocodierenden Adresse
4.7 Weitere Parameter
Die größe des der zurückgeliferten Bitmap kann mit nachfolgenden Parametern bestimmt
werden.
Parameter
iw
ih
Typ
Beschreibung
Numeric
(integer)
Die Bitmapgröße in Pixeln (iw = Breite, ih = Höhe)
4.8 Map24-CGI Info-Service
Der Status einer Map24-CGI-Session lässt sich ebenfalls über einen HTTP-Aufruf
abfragen. Mit folgendem Aufruf wird der Infoservice angefragt:
http://maptp.map24.com/map24/cgi?action=info&mid=<Map24 -ID>&sid=<sessionID>
Die Ausgabe erfolgt im Mime-Type text/plain und hat folgendes Format:
mid=<MAP24-ID>
sid=<sessionID>
wx=<X-Koordinate>
wy=<Y-Koordinate>
width=<Ausschnittsbreite>
height=<Ausschnittshöhe>
iw=<Bildbreite in Pixel>
ih=<Bildhöhe in Pixel>
Map24-Bitmap-Mapping
Seite 7
5 Maplets - Interaktives Mapping
Mit Map24 haben Sie auch die Möglichkeit, die einzigartige interaktive Kartenlösung
NETSOLUT MapTP auf Ihrer Homepage zu integrieren. Mit einem Maplet (MappingApplet) können Sie völlig frei mit hoher Geschwindigkeit navigieren – ein Arbeiten wie
auf CD-ROM wird möglich.
Im folgenden werden Sie mit den technischen Einzelheiten der Einbindung eines Map24Maplets vertraut gemacht. Sie können somit selbst nahezu unbegrenzte MappingFunktionalität in Ihre WebSite integrieren.
5.1 Applet-Tag
Um das Maplet in Ihre WebSite einzubinden, benötigen Sie lediglich einen Applet-Tag.
5.1.1 Basis-Tag
Der Basis-Applet-Tag für ein Map24-Maplet lautet:
<APPLET code="com.netsolut.map24.Map24.class" align="baseline"
width="550" height="400"
codebase="http://maptp.map24.com/map24"
archive="http://maptp.map24.com/map24/map24.zip">
<PARAM name="<name>" value="<value>">
</APPLET>
Zusätzlich können (und müssen) innerhalb des Applet-Tags weitere Parameter (PARAMTag) definiert werden.
5.1.2 Applet-Parameter
Zusätzlich zu dem Basis-Applet-Tag können noch weitere Parameter bei dem AppletAufruf definiert werden:
5.1.2.1 Map24
Die Map24-ID identifiziert den Map24-Kunden. Jeder Applet-Aufruf muß diese ID
enthalten, sonst startet das Applet nicht.
Parameter
mid
Typ
Beschreibung
STRING
Map24-ID
5.1.2.2 Session-ID
Über die Session-ID ist es möglich, das Maplet fernzusteuren und weitere bestimmte
Steuerbefehle an das Maplet zu senden (siehe Abschnitt 5.2). Die Session-ID muß
eindeutig vergeben werden.
Parameter
sid
Typ
Beschreibung
STRING
Session-ID
5.1.2.3 Look & Feel
Über eigene Parameter kann zusätzlich die auf dem Map24-Administrationsseiten
vorgenommenen Voreinstellungen für das Look & Feel pro Applet-Aufruf übersteuern.
Parameter
Typ
Maplets - Interaktives Mapping
Beschreibung
Seite 8
skin
STRING
Skin-ID
(mit diesem Parameter kann die Standard-Skin-Einstellung in der Map24Datenbank-überschrieben werden und für diesen Aufruf ein alternatives
Skin angegeben werden).
lang
STRING
In welcher Sprache wird das Maplet gestartet. Mögliche Werte:
de
Deutsch
en
Englisch
weitere Sprachen werden sukzessive hinzugefügt.
5.1.2.4 Startausschnitt
Über Applet-Parameter kann der Startausschnitt der Karte festgelegt werden. Dazu wird
ein Punkt auf der Karte (entweder über eine vordefinierte Location oder über eine
Koordinate) definiert sowie die Breite des Kartenausschnittes in Metern angegeben. Diese
Angaben übersteuern die voreingestellten Werte auf den Administrationsseiten.
Parameter
Typ
Beschreibung
start_locid
STRING
Das Applet startet mit der entsprechenden Location als Mittelpunkt. Die
Location-ID kann entweder eine von den auf den Administrationsseiten
vordefinierten Locations sein oder eine weitere, als Applet-Parameter
definierte Location (siehe Abschnitt 5.1.2.5).
start_x
start_y
Numeric
(float)
X- und Y-Koordinate des Mittelpunktes des Startbereiches (in Minuten)
start_width
Numeric
(integer)
Breite des Startausschnittes in Metern.
5.1.2.5 Verknüpfen der Locations mit Aktionen
In manchen Situationen ist es sinnvoll, bei einem Click auf die Location eine bestimmte
Aktion auszuführen. Mit Hilfe der nachfolgenden Parameter wird beim Click auf die
Location eine frei definierbare URL angesprungen, und zusätzlich die Werte der SessionID, Location-ID, X- und Y-Koordinate sowie die Ausschnittsbreite in Metern übergeben.
Parameter Typ
locurl
STRING
Beschreibung
Beim Klick auf eine Location wird diese URL, erweitert durch die Parameter
Location-ID, X-Koordinate, Y-Koordinate, Ausschnittsbreite in Metern in der
Form
sid=<sessionID>&locid=<LOCID>&wx=<X>&wy<Y>&width=<Ausschnittsbreite>
aufgerufen.
ACHTUNG: Durch setzen dieses Parameters
zugeordneten URLs außer Kraft gesetzt.
loctarget
STRING
werden
die
den
Locations
Name des Frames, in der die aufgerufene Seite erscheint. Der Default-FrameName ist „_top“, sodaß die Seite im aktuellen Frame/Fenster erscheint.
5.1.2.6 Zusätzliche Locations
Neben den auf den Administrationsseiten definierten Locations, können einem Applet
zusätzlich beim Starten weitere Locations übergeben werden. Diese werden entweder
direkt über Koordinaten oder per Übergabe einer Adressinformation definiert. Es können
beliebig viele Locations auf einmal definiert werden, wobei die Parameter für diese
Locations von 0 beginnend lückenlos durchnummeriert werden müssen. Damit eine
solche Location erkannt wird, muß mindestens der description<x>- oder der locid<x>Parameter definiert sein.
Parameter
locid<x>
Typ
Beschreibung
STRING
Sie können eine für diese Benutzersitzung spezifische Location-ID
spezifizieren, mit der sie dann in weiteren Schritten diese Location
referenzieren können (z.B. bei der Bestimmung der Startausschnittes oder
Maplets - Interaktives Mapping
Seite 9
beim Fernsteuern des Maplets).
description<x>
STRING
Der hier angegebene Text wird in einem Tooltip zu der Location angezeigt,
wenn man mit der Maus auf diese Location zeigt. Zeilenumbrüche in der
Anzeige können mit dem Zeichen „|“eingegeben werden.
url<x>
STRING
URL, mit der die Location verknüpft wird.
logo_url<x>
STRING
An der Stelle der Location wird in hohen Zoomstufen dieses Logo
angezeigt.
sym<x>
Numeric
(integer)
In niedrigen Zoomstufen wird anstatt dem Logo ein Symbol dargestellt,
welches auch nicht verkleinert wird. Das Symbol kann aus der Map24Symbolbibliothek ausgewählt werden:
http://www.map24.com/mymap24/symbols.php3
Die Position der Location wird entweder über Koordinaten gegeben...
x<x>
Numeric
(float)
X-Koordinate der Location in Minuten (falls Vorhanden)
y<x>
Numeric
(float)
Y-Koordinate der Location in Minuten (falls Vorhanden)
… oder die Position wird durch Angabe einer vollständigen Adresse durch den eingebauten Geocodierer
ermittelt.
street<x>
STRING
Straße der zu geocodierenden Adresse
zip<x>
STRING
Postleitzahl der zu geocodierenden Adresse
city<x>
STRING
Stadt der zu geocodierenden Adresse
country<x>
STRING
Land der zu geocodierenden Adresse
5.1.3 Beispiel
Nachfolgender Applet-Code öffnet ein Map24-Maplet mit
Startausschnit (mit einer Ausschnittsbreite von 5000 Metern).
Frankfurt/Main
als
<APPLET code="com.netsolut.map24.Map24.class" align="baseline"
width="550" height="400"
codebase="http://maptp.map24.com/ map24"
archive="http://maptp.map24.com/map24/map24.zip">
<PARAM
<PARAM
<PARAM
<PARAM
<PARAM
name="mid"
name="sid"
name="start_x"
name="start_y"
name="start_width"
value="MAP24">
value="88204addb01bf227f4">
value="520.546330921319">
value="3007.9021226760296">
value="5000">
</APPLET>
5.2 Administrationsmodus
Mit dem Administrationsmodus läßt sich ein ausgewählter Ausschnitt speichern bzw. die
Positionen der angezeigten Locations verschieben und speichern. Die Speicherung erfolgt
durch Aufruf einer URL, an die zusätzlich die neuen Koordinaten als Parameter angehängt
werden. Somit ist es möglich, auch eigene Administrationsseiten zu bauen.
Der Administrationsmodus wird durch Angabe der nachfolgenden beiden AppletParameter aktiviert:
Parameter
Typ
Beschreibung
ADMBASEURL
STRING
Basisurl der Administrationsseite, die beim Speichern des aktuellen
Ausschnittes oder der aktuellen Position einer Location aufgerufen wird.
ADMTARGET
STRING
Name des Frames, in der die aufgerufene Administrationsseite erscheint.
Der Default-Frame-Name ist „_top“, sodaß die Seite im aktuellen
Maplets - Interaktives Mapping
Seite 10
Frame/Fenster erscheint.
5.2.1 Kartenausschnitt bestimmen
Wenn das Applet im Administrationsmodus gestartet wird, lässt sich mit der Taste <F9>
der aktuelle Kartenausschnitt speichern. Dabei wird die im Parameter ADMBASEURL
angegebene Administrationsurl aufgerufen und die folgende Zeichenkette angehängt:
wx=<x-coordinate>&wy=<y-coordinate>&width=<width-in-meter>
Die so übergebenen Werte können jetzt Scriptseitig verarbeitet werden.
5.2.2 Position einer Location speichern
Wird das Applet mit (vordefinierten oder geocodierten) Locations aufgerufen, lassen sich
diese per Drag & Drop auf der Karte einfach verschieben. Sobald die Location verschoben
wurde, wird dies mit dem Text „not saved“ gekennzeichnet. Ein Doppelklick auf diese
Location ruft die Administrationsseite auf. Dabei wird an die aufgerufene URL folgende
Zeichenkette angehängt
locid=<Location-ID>&wx=<x-coordinate>&wy=<y-coordinate>&width=<width-inmeter>
Die Location-ID ist entweder der in der Map24-Datenbank gespeicherte Identifier für
diese Location oder der per Appletparameter übergebene Identifier locid (s.a. Abschnitt
5.1.2.5).
5.3 MRC – Maplet Remote Control
5.3.1 Was ist MRC?
MRC – oder „Maplet Remote Control” – bezeichnet die Möglichkeit, ein Map24-Maplet
fernzusteuern. Die Fernsteuerung erfolgt über das Absetzen von HTTP-Requests, also
durch ganz normales Abrufen einer URL.
Das Fernsteuern eines Maplets beinhaltet Funktionen wie z.B. das Aufrufen bestimmter
Kartenausschnitte, das relative navigieren in der Karte (z.B. Zoom-In, Move-North) oder
auch das Geocodieren und darstellen von neuen Locations zur Laufzeit.
Das fernzusteuerende Maplet wird über eine eindeutige Session-ID identifiziert, sodaß
auch das fernsteuern von fremden Rechnern aus möglich wäre.
5.3.2 Funktionsprinzip
Die Basis-URL eines Aufrufs zum Fernsteuern lautet:
http://maptp.map24.com/map24/control?<parameter>
Zurückgeliefert wird immer ein 1x1-Pixel großes transparentes GIF-Bild. Somit lassen
sich solche Remote-Control-Requests auch bequem in HTML-Seiten unterbringen, ohne
dass das Layout einer Seite beeinträchtigt wird.
5.3.3 Parameter
Die Parameter können, wie bei jedem HTTP-Aufruf standardmäßig mit der GET- (URLcodiert) oder mit der POST-Methode übergeben werden.
Maplets - Interaktives Mapping
Seite 11
Die nachfolgend beschriebenen Parameter sind obligatorisch für jeden Remote-ControlRequest:
Parameter
Typ
Beschreibung
mid
STRING
Die Map24-ID des Kunden (s. Abschnitt 5.1.2.1)
sid
STRING
Die eindeutige Session-ID für dieses Maplet. Der Systemintegrator muß
dafür Sorge tragen, dass die Session-IDs pro Map24-ID eindeutig sind.
action
STRING
Gibt an, welche Remote-Control-Operation durchgeführt werden soll
(Details in weiteren Abschnitten).
Beispiel für einen Remote-Control-Request mit der GET-Methode (URL-codiert):
http://maptp.map24.com/map24/control?mid=MAP24&sid=uj90bjl345uidfgj&action=
<Action>&<additional-parameters>
Im nachfolgenden werden die einzelnen Remote-Control-Operationen vorgestellt.
5.3.3.1 Darstellen eines Kartenausschnittes
Der Positionierungsbefehl (action=POS) setzt den aktuellen Kartenausschnitt durch
Angabe von Mittelpunktkoordinaten (in Minuten) und einer Ausschnittsbreite (in Meter)
neu.
Parameter
Typ
Beschreibung
action
STRING
=POS
x
STRING
X-Koordinate des Mittelpunktes des neuen Ausschnittes in Minuten.
y
STRING
Y-Koordinate des Mittelpunktes des neuen Ausschnittes in Minuten.
width
STRING
Ausschnittsbreite in Metern
5.3.3.2 Darstellen einer Maplet-Location
Eine Maplet-Location wird in der Map24-Datenbank anhand einer eindeutigen Location-ID
abgespeichert. Der Positionierungsbefehl für Locations (action=LOC) setzt den aktuellen
Kartenausschnitt auf die angegebene Location.
Parameter
Typ
Beschreibung
action
STRING
=LOC
id
STRING
Die Location-ID aus der Map24-Datenbank
width
STRING
Ausschnittsbreite in Metern.
5.3.3.3 Maplet-Navigation
Über Navigationsbefehle (action=NAV) lassen sich Steuerbefehle zum Navigieren an das
Maplet schicken.
Maplets - Interaktives Mapping
Seite 12
Parameter
Typ
Beschreibung
action
STRING
=NAV
navigation
STRING
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
=
HOME
ZOOMIN
ZOOMOUT
NORTHWEST
NORTH
NORTHEAST
EAST
SOUTHEAST
SOUTH
SOUTHWEST
WEST
MAX
MIN
BACK
FORWARD
ZOOM<x>
(Rückkehr zur Startansicht)
(Reinzoomen)
(rauszoomen)
(Kartenausschnitt nach Nordwesten bewegen)
(... nach Norden)
(... nach Nordosten)
(... nach Osten)
(... nach Südosten)
(... nach Süden)
(... nach Südwesten)
(... nach Westen)
(maximiert das Applet-Fenster)
(minimiert das Applet-Fenster)
(Ein Schritt zurück in der Historie der Kartenausschn.)
(Ein Schritt nach vorne...)
(Zoomfaktor in Prozent: x von 0..100)
5.3.3.4 Geocodieren und Darstellen einer Adresse
Über diesen Befehl (action=GC) lässt sich eine neue Location anhand einer Adresse
spezifizieren. Die Adresse wird geocodiert und dem Maplet übermittelt, der
Kartenausschnitt fährt dann automatisch zu der Position der neuen Location.
Standardmäßig wird lediglich eine Markierung gesetzt, die man mit einem Klick wieder
entfernen kann. Durch den Parameter noflag=1 wird anstatt eine Markierung eine
vollständige Location in das Maplet gesetzt, welche während der Maplet-Session erhalten
bleibt.
Parameter
Typ
Beschreibung
action
STRING
=GC
id
STRING
eine temporäre Location-ID, mit der diese Location in späteren MRCRequests angesteuert werden kann.
s
STRING
Die Straße der zu geocodierenden Adresse.
z
STRING
Die Postleitzahl der zu geocodierenden Adresse.
c
STRING
Die Stadt der zu geocodierenden Adresse.
cn
STRING
Das Land der zu geocodierenden Adresse.
d
STRING
Die Beschreibung, die an der Location angezeigt werden soll.
Zeilenumbrüche werden durch ein | (senkrechter Strich) markiert.
u
STRING
Die URL, mit der die Location verlinkt werden soll.
l
STRING
Die Logo-URL des Logos, welches an der Stelle angezeigt werden soll.
width
STRING
Breite des Kartenausschnitts in Meter.
noflag
STRING
=1
5.3.3.5 Hinzufügen von Locations zum Applet zur Laufzeit
Mit dem MRC-Befehl „ADDLOC“ können zur Laufzeit mehrere Locations auf einmal dem
Applet hinzugefügt werden. Hierbei müssen die Geokoordinaten bereits bekannt sein, es
findet keine Geokodierung statt. Die Parameter für diese Locations müssen von 0
beginnend lückenlos durchnummeriert werden.
Maplets - Interaktives Mapping
Seite 13
Parameter
Typ
Beschreibung
action
STRING
=ADDLOC
id<x>
STRING
eine temporäre Location-ID, mit der diese Location in späteren MRCRequests angesteuert werden kann.
d<x>
STRING
Die Beschreibung, die an der Location angezeigt werden soll.
Zeilenumbrüche werden durch ein | (senkrechter Strich) markiert.
u<x>
STRING
Die URL, mit der die Location verlinkt werden soll.
l<x>
STRING
Die Logo-URL des Logos, welches an der Stelle angezeigt werden soll.
x<x>
y<x>
FLOAT
X- und Y-Koordinate der Location
INTEGER
In niedrigen Zoomstufen wird anstatt dem Logo ein Symbol dargestellt,
welches auch nicht verkleinert wird. Das Symbol kann aus der Map24Symbolbibliothek ausgewählt werden:
sym<x>
http://www.map24.com/mymap24/symbols.php3
5.3.3.6 Entfernen von Locations aus dem Applet zur Laufzeit
Locations können auch nachträglich wieder aus dem Applet zur Laufzeit entfernt werden.
Dazu müssen die Location-IDs der zu entfernenden Locations übergeben werden. Die
Parameter müssen von 0 anfangend aufsteigende durchnummeriert werden.
Wenn einer der ID-Paramter auf „REMOVEALL“ gesetzt ist, werden alle Locations aus
dem Applet gelöscht.
Parameter
Typ
Beschreibung
action
STRING
=REMOVELOC
id<x>
STRING
Die LocationIDs, der zu löschenden Locations.
Beispiel:
http://maptp.map24.com/map24/control?mid=MAP24&sid=uj90bjl345uidfgj&action=
REMOVELOC&ID0=1&ID1=1 2
Dieser Befehl löscht aus dem durch die Map24-ID und Session-ID bestimmten Applet die
Locations mit der ID 1 und 12.
5.3.3.7 Berechnen und Darstellen einer Route
Es ist möglich, eine Route mit dem Map24-Routingservice berechnen zu lassen und an
das Maplet zu schicken (action=ROUTE).
Parameter
action
Typ
Beschreibung
STRING
=ROUTE
Entweder eine bereits vorberechnet Route wird anhand der Routing-ID (rid) abgerufen und dargestellt...
rid
STRING
eine temporäre Location-ID, mit der diese Location in späteren MRCRequests angesteuert werden kann.
…oder eine neue Route wird anhand der nachfolgenden Parameter berechnet und angezeigt.
type
INTEGER
Typ der Route (wird noch festgelegt…)
xs
FLOAT
X-Koordinate des Startpunktes in Minuten
ys
FLOAT
Y-Koordinate des Startpunktes in Minuten
xd
FLOAT
X-Koordinate des Zielpunktes in Minuten
yd
FLOAT
Y-Koordinate des Zielpunktes in Minuten
Maplets - Interaktives Mapping
Seite 14
5.3.3.8 Abfragen von Informationen über das Applet
Der aktuelle Kartenausschnitt eines Maplet (und zukünftig noch weitere Informationen)
können über einen MRC-Befehl abgefragt werden.
Parameter
Typ
Beschreibung
action
STRING
=INFO
mid
STRING
Die Map24-ID des Maplet
sid
STRING
Die Session-ID des Maplet
Die Ausgabe erfolgt im Mime-Type text/plain und hat folgendes Format:
mid=<MAP24-ID>
sid=<sessionID>
wx=<X-Koordinate>
wy=<Y-Koordinate>
width=<Ausschnittsbreite>
6 Routing
Sie können sich Routen berechnen lassen und Wegbeschreibungen generieren lassen.
Dabei wird grundsätzlich zunächst eine Routenberechnung vorgenommen, ehe die Route
dann in der Bitmap- oder Applet-Karte angezeigt werden kann (im Applet ist die Option
zur Routenplanung allerdings schon integriert und muss nicht zwangsläufig von außen
erzeugt werden).
6.1 Basis-URL
Die Basis-URL des Map24-Routing Services lautet:
http://maptp.map24.com/map24/routing?mid=<Map24 -ID>
Die Map24-ID identifiziert den Map24-Kunden. Jeder Aufruf muß diese ID enthalten,
sonst wird keine gültige Antwort zurückgeliefert. Außerdem enthält ein Aufruf weitere
Parameter, die in den folgenden Abschnitten definiert werden.
Routing
Seite 15
6.2 Parameter
6.2.1 Erzeugen einer Routing ID
Damit in den Bitmap- oder Applet-Karten eine Route angezeigt werden kann, benötigen
sie eine Routing ID (rid). Ebenfalls benötigt wird die rid für die Berechnung der
Wegbeschreibung (s. 6.3.).
Parameter
action
Typ
Beschreibung
STRING
=CALC
Entweder werden Start- und Zielpunkt als Koordinaten angegeben...
fx
FLOAT
X Koordinate der Startadresse in Minuten
fy
FLOAT
Y Koordinate der Startadresse in Minuten
tx
FLOAT
X Koordinate der Zieladresse in Minuten
ty
FLOAT
Y Koordinate der Zieladresse in Minuten
…oder Start- und Zielpunkt werden als Location IDs angegeben...
flocid
INTEGER
Location ID der Startadresse
tlocid
INTEGER
Location ID der Zieladresse
…oder Start- und Zielpunkt werden als Adressen angegeben...
fs
STRING
Straße und Hausnummer der Startadresse
fz
STRING
Postleitzahl der Startadresse
fc
STRING
Ortsname der Startadresse
fcn
STRING
Länderkennung der Startadresse
(entweder ISO-3166 oder Autokennzeichen)
ts
STRING
Straße und Hausnummer der Zieladresse
tz
STRING
Postleitzahl der Zieladresse
tc
STRING
Ortsname der Zieladresse
tcn
STRING
Länderkennung der Zieladresse
(entweder ISO-3166 oder Autokennzeichen)
Optional können noch weitere Parameter angegeben werden:
rtype
STRING
= FAST
schnellsten Strecke
= SHORT
Kürzeste Strecke
Voreingestellt ist die Berechnung der schnellsten Strecke
frn
STRING
Straßenname der Startadresse (nur Beschriftung)
trn
STRING
Straßenname der Zieladresse (nur Beschriftung)
cid
STRING
Eindeutige ID für dieses Routing
Die Parameter für Start- und Zieladresse können auch gemischt werden, also z.B.
Adressparameter für die Startadresse und Location ID für die Zieladresse. Bitte beachten
Sie, dass bei manchen Produkten als Zielparameter nur die Location-ID verwendet
werden kann.
Die Ausgabe erfolgt im Mime-Type text/plain und hat folgendes Format:
REFID <ROUTING ID>
Routing
Seite 16
6.2.2 Berechnung der Wegbeschreibung
Parameter
action
Typ
Beschreibung
STRING
=DESC
Optional können noch weitere Parameter angegeben werden:
spd1
INTEGER
Durchschnittsgeschwindigkeit auf Autobahnen in km/h
spd2
INTEGER
Auf Bundesstraßen in km/h
spd3
INTEGER
Auf Landstraßen in km/h
spd4
INTEGER
Auf Orts- und Nebenstraßen in km/h
spd5
INTEGER
Auf anderen Straßen in km/h
Die Angabe der Durchschnittsgeschwindigkeiten beeinflusst die Berechnung der Fahrtzeit
für die einzelnen Routenabschnitte. Dabei ist spd1 für die schnellsten Straßentypen und
spd5 für die langsamsten.
<<Die spd-Parameter sind zur Zeit noch nicht funktional.>>
Die Ausgabe der Webgeschreibung erfolgt im Mime-Type text/plain und hat folgendes
Format:
DESC <ROUTING ID>
<ANZAHL DER WEGPUNKTE n>
<WEGPUNKT 1>
<WEGPUNKT 2>
.
.
.
<WEGPUNKT n>
END
Die einzelnen Zeilen für die Wegpunkte bestehen wiederum aus, durch das „|“-Zeichen
abgetrennten, folgenden Einzelinformationen:
Straßenname
X-Koordinate (Start dieses Abschnitts)
Y-Koordinate (Start dieses Abschnitts)
Straßenname
Straßenbezeichnung
Weglänge des Abschnitts
Fahrtzeit des Abschnitt
Anzahl Knotenpunkte
Straßentyp
Straßentyp ID
Ausfahrt Nr.
Seite 17