X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

Operation: CreateGoogleURL

Diese Operation erzeugt eine URL für Google APIs, insbesondere für die Maps Static API. Über den Parameter privateKey kann eine URL-Signierung im Adapter-Output hinzugefügt werden.

Input

Für die Operation CreateGoogleURL erwartet der Adapter eine XML-Input-Struktur nach folgendem Muster:

XML
<?xml version="1.0" encoding="UTF-8"?>
<RootElement>
    <Path>/maps/api/staticmap</Path>
    <Param name="center">59.900503,-135.478011</Param>
    <Param name="zoom">4</Param>
    <Param name="size">400x400</Param>
    <Param name="path">fillcolor:0x0000AA33|color:0xFFFFFF00|enc:_qo]~po]koBqtmV|@{lcNlmBq_mUvnuO?fsik@??~b`|@}g`h@?az~R?</Param>
</RootElement>

Das Wurzelelement enthält folgende Elemente:

Element

Beschreibung

<Path>

URL-Part der Google Static Maps API (siehe http://code.google.com/intl/de-DE/apis/maps/documentation/staticmaps/)

<Param>

Definiert den zu erzeugenden Kartenausschnitt über Parameter. Jeder Parameter wird als eigenes <Param>-Element angegeben.

XML
<Param name="parameterName">parameterValue</Param>

Typische Parameter:

  • center: Definiert den Mittelpunkt der Karte.

<Param name="center">59.900503,-135.478011</Param>

Mögliche Werte:

  • Breitengrad, Längengrad

  • Eingabe einer Adresse (z. B. "Berlin, DE")

  • zoom: Legt die Zoomstufe fest.

<Param name="zoom">4</Param>

Mögliche Werte:

  • Wertebereich: in der Regel 0–21

  • size: Definiert die Bildgröße.

<Param name="size">400x400</Param>

Mögliche Werte:

  • Breite x Höhe in Pixel

  • path: Definiert Linien oder Flächen auf der Karte.

<Param name="path">fillcolor:0x0000AA33|color:0xFFFFFF00|enc:...</Param>

Mögliche Bestandteile:

  • color: Linienfarbe

  • fillcolor : Füllfarbe

  • enc: kodierte Polyline

Hinweis:

Mehrere Eigenschaften werden durch | getrennt.

  • markers: Definiert eine Stecknadelmarkierung.

XML
<Param name="markers">color:red|label:A|59.900503,-135.478011</Param>

Mögliche Bestandteile:

  • color: Farbe des Markers

  • label : Beschriftung des Markers

Hinweis:

  • Mehrere Eigenschaften werden durch | getrennt.

  • Die Positionsangabe über Breitengrad und Längengrad steht immer am Ende.

Output

Wenn die Operation erfolgreich ausgeführt wurde, gibt der Adapter ein XML-Dokument aus mit einer URL zu dem über den Input definierten Google-Maps-Kartenausschnitt. Das outputFormat hat keine Auswirkung auf die Zusammensetzung der URL.

<HREF>https://maps.google.de?path=&size=&sensor=false&markers=48.952663786788165%2C+8.390965795490331&signature=9BCZz3mKiXcWJ1e6jl4puG1XUhI=</HREF>

Beispiele

Hier finden Sie verschiedene Beispiele für die Operation CreateGoogleURL

.

Beispiel 1: Einzelner Marker mit Koordinaten

Input

XML
<RootElement>
    <Path>/maps/api/staticmap</Path>
    <Param name="center">52.5200,13.4050</Param>
    <Param name="zoom">10</Param>
    <Param name="size">400x400</Param>
    <Param name="markers">color:red|52.5200,13.4050</Param>
</RootElement>

Output

XML
<HREF>https://maps.googleapis.com/maps/api/staticmap?center=52.5200%2C13.4050&amp;zoom=10&amp;size=400x400&amp;markers=color%3Ared%7C52.5200%2C13.4050&amp;key={API_KEY}</HREF>
Beispiel 2: Mehrere Marker mit unterschiedlichen Eigenschaften

Input

XML
<RootElement>
    <Path>/maps/api/staticmap</Path>
    <Param name="size">600x400</Param>
    <Param name="markers">color:blue|label:B|52.5200,13.4050</Param>
    <Param name="markers">color:green|label:M|48.1351,11.5820</Param>
</RootElement>

Output

XML
<HREF>https://maps.googleapis.com/maps/api/staticmap?size=600x400&amp;markers=color%3Ablue%7Clabel%3AB%7C52.5200%2C13.4050&amp;markers=color%3Agreen%7Clabel%3AM%7C48.1351%2C11.5820&amp;key={API_KEY}</HREF>
Beispiel 3: Mehrere Marker mit gemeinsamen Eigenschaften

Input

XML
<RootElement>
    <Path>/maps/api/staticmap</Path>
    <Param name="center">Germany</Param>
    <Param name="zoom">5</Param>
    <Param name="size">600x400</Param>
    <Param name="markers">color:red|label:A|52.5200,13.4050|48.1351,11.5820</Param>
</RootElement>

Output

XML
<HREF>https://maps.googleapis.com/maps/api/staticmap?center=Germany&amp;zoom=5&amp;size=600x400&amp;markers=color%3Ared%7Clabel%3AA%7C52.5200%2C13.4050%7C48.1351%2C11.5820&amp;key={API_KEY}</HREF>