Erstellung der Karte
Der erste Schritt nach Einbindung der API ist die Erstellung der Karte. Rufen Sie dazu die
"create"-Funktion der Klasse Map auf. Map ist global unter
window.de.businessatlas zu finden. Der Funktion übergeben sie nun das
Elternelement, welches die eingebettete Karte enthalten soll.
Wichtig: Übergeben Sie das DOM-Element.
Optional können Sie noch ein weiteres Objekt als Parameter mitgeben. Dieses kann ein
Initiales Zentrum (X- und Y-Koordinate) und/oder eine initiale Zoomstufe enthalten.
Außerdem ist es möglich die Punkte auf der angezeigten Karte verschiebbar zu machen.
Zentrierung der Karte
Die Karte können sie mit der "center"-Funktion des Map-Objektes um einen Punkt zentrieren. Diese Funktion erwartet die X- und Y-Koordinate als Parameter. Optional können Sie noch eine Zoomstufe zwischen 0 und 23 angeben um gleichzeitig die Karte zu zoomen.
Hinzufügen eines Punktes
Unter Angabe der X- und Y-Koordinaten können Sie ganz leicht einen Punkt der Karte hinzufügen. Rufen Sie die "addPoint"-Funktion am Map-Objekt auf und übergeben sie dieser Funktion die Koordinaten Ihres Punktes.
Veränderung des Zooms
Sie können in der Karte programmatisch heraus oder hineinzoomen. Nutzen Sie dafür die "zoom"-Funktion des Map-Objektes. Diese Funktion erwartet eine Zahl zwischen 0 und 23 als Parameter. Wobei 0 der Welt- und 23 der Gebäudeansicht entspricht.
Geocodierung
Nutzen Sie die Geocoding API mithilfe der business atlas JavaScript API. Setzen Sie zunächst Ihre Credentials am window.de.businessatlas.api.IdentityManager-Objekt mit der setCredentials-Funktion. Alternativ kann auch ein anderweitig generierter business atlas Token, mit Hilfe der setToken-Funktion, verwendet werden. Anschließend können Sie die beiden Funktionen des window.de.businessatlas.api.Geocoder verwenden. Diese sind die suggestSingleLine-Funktion, falls Sie die gesammte Adresse als String vorliegen haben und die suggest-Funktion, die ein Objekt erwartet. Dieses Objekt kann Straßennamen mit Hausnummer, Postleitzahl, Stadt und/oder Land enthalten.