Zum Inhalt

Standortkarte

Erstellen Sie Standortkarten für die Verwendung auf Ihrer Website. Über die hier beschriebene Schnittstelle können Sie Standortkarten in verschiedenen Formaten und Konfigurationen erstellen.

Einstiegspunkte

Der Dienst wird als GET-URL-Dienst bereitgestellt und kann somit beispielsweise verlinkt oder als Inlineframe eingebunden werden.

URL

Der Kartenausschnitt wird durch eine Adresse oder Koordinate festgelegt: https://location.smartmaps.app/?key={[INSERT API-KEY]}

Inlineframe-Integration

Einbettung über Inlineframe

<iframe src="https://location.smartmaps.app/?key={[INSERT API-KEY]}" style="height: 100%; width: 100%; border: 0;" title="SmartMaps"></iframe>

Beispiel

GET-Parameter

Authentifizierung

Um die Standortkarte zu nutzen, benötigen Sie einen API-Key. Den API-Key erhalten Sie bei der Registrierung direkt von YellowMap. Sie müssen den API-Key im Parameter key übergeben.

Name Beschreibung Datentyp Standardwert
key API-Key (wird direkt von YellowMap bereitgestellt). string

Karteneinstellungen

Mit diesen Parametern können Sie das Verhalten und das Erscheinungsbild der Karte anpassen. Die Parameter müssen URL-codiert übergeben werden.

Name Beschreibung Datentyp Standardwert
ch Channel: Eine Zeichenfolge, die protokolliert wird; sie kann vom Nutzer frei gewählt werden. String
fsc FullscreenControl: Gibt an, ob die Karte im Vollbildmodus geöffnet werden kann. bool false
zc ZoomControl: Gibt an, ob der Zoom-Regler standardmäßig zur Karte hinzugefügt wird. bool false
z Zoom: Ursprünglicher Zoomwert. int 1-19 19
minz Minzoom: Minimale Zoomstufe der Karte. int 1-19 4
maxz Maxzoom: Maximale Zoomstufe der Karte. int 1-19 19
swz ScrollWheelZoom: Gibt an, ob die Karte mit dem Mausrad gezoomt werden kann. bool true
gc GestureControl: Gibt an, ob die Karte nur mit zwei Fingern / Strg + Mausrad gezoomt werden kann. bool false
static Static: Die Karte kann nicht verschoben oder gezoomt werden. bool false
mh MapHeight: Gibt die Höhe der Karte an. Werte werden als px oder % angegeben. Wichtig: Werte müssen URL-codiert werden. string 100%
s Style: Einstellung des auf der Karte anzuzeigenden Kartenprofils. Standardmäßig wird das Standardprofil Lightmode von SmartMaps geladen. Sie können zwischen verschiedenen, an die jeweilige Anwendung angepassten Profilen wählen. Bei Verwendung von auto wird abhängig von den Einstellungen des Endgeräts/Betriebssystems automatisch der Light- oder Dark-Modus verwendet. auto,light,dark,essential,grey,accessible light
tc Terrain Control: Aktiviert ein Control zur weltweiten Anzeige von Terrain-Daten. bool false
l Language: Die Sprache der Karte. string local
p Projection: Die Projektion der Karte. string auto
sc Style Control: Gibt an, ob das Style Control zur Karte hinzugefügt wird. bool false

Marker & Pop-up

Mit diesen Parametern können das Verhalten und das Erscheinungsbild von Marker und Pop-up angepasst werden. Die Parameter müssen URL-codiert übergeben werden.

Name Beschreibung Datentyp Standardwert
y Lat: Gibt den Breitengrad des Markers an. Wenn keine Adresse angegeben ist, wird die Koordinate geocodiert. number null
x Lng: Gibt den Längengrad des Markers an. Wenn keine Adresse angegeben ist, wird die Koordinate geocodiert. number null
zp Zip: Die Postleitzahl der zu geocodierenden Adresse. Wenn keine Koordinate angegeben ist, wird die Adresse geocodiert. String null
cty City: Die Stadt der zu geocodierenden Adresse. Wenn keine Koordinate angegeben ist, wird die Adresse geocodiert. String null
str Street: Die Straße der zu geocodierenden Adresse. Wenn keine Koordinate angegeben ist, wird die Adresse geocodiert. String null
hsn HouseNo: Die Hausnummer der zu geocodierenden Adresse. Wenn keine Koordinate angegeben ist, wird die Adresse geocodiert. String null
ic IsoCountry: Der ISO-Ländercode der zu geocodierenden Adresse. Wenn keine Koordinate angegeben ist, wird die Adresse geocodiert. String "DE"
c Color: Die Farben der auf der Karte darzustellenden Marker. Vier Hexadezimalwerte für Rot, Grün, Blau und den Alphakanal.
Wichtig: Werte müssen URL-codiert werden.		 #HEX-Color #18355b
i Icon: Name des im Marker anzuzeigenden Maki-Icons, z. B. i=aerialway. String
is iconSize: Legt die Größe des Markers fest. Werte sind S, M, L und XL String "M"
hp hasPopup: Legt fest, ob der Marker ein Pop-up hat. bool true
pt header: Gibt die Überschrift des Pop-ups an. String
pb body: Gibt den Inhalt des Pop-up-Bodys an. String
op open Popup: Legt fest, ob das Pop-up standardmäßig geöffnet ist. bool true

Marker-Icons

Der Parameter i akzeptiert jeden Maki Icon-Namen (z. B. i=aerialway). Maki-Icons sind unter CC0 lizenziert.

Hinweis

Um das Pop-up anzuzeigen, werden Adressinformationen benötigt. Werden diese nicht über die entsprechenden Parameter bereitgestellt, werden sie automatisch über den Reverse-Geocoding-Dienst ermittelt. Daher muss Ihr API-Key für die Anwendungsdomain location.smartmaps.app freigeschaltet sein.