Inhalt:

Daten- / Objektstruktur
Füllen von Daten
Chartkonfiguration
- Setzen API-Key
- Konfiguration XdevMapChart allgemein

Achtung: Für die Verwendung der XdevGeoChart oder XdevMapChart ist ein Google API-Key erforderlich. Dieser API-Key kann hier angefordert werden.

Optimale Datenstruktur (Datenbank):

Lat	Long	Beschriftung

Lat	Long	Beschriftung
37.4232	-122.0853	"Work"
37.4289	-122.1697	"University"
37.6153	-122.3900	"Airport"
...

oder

Adresse	Beschriftung

Adresse	Beschriftung
"Musterweg 16 92225 Musterndorf"	"Work"

Optimale Objektstruktur (Java)

public class MapChartObject {
	private Double longitude;
	private Double latitude;
	private String name;

	public Double getLongitude() {
		return longitude;
	}

	public void setLongitude(Double longitude) {
		this.longitude = longitude;
	}

	public Double getLatitude() {
		return latitude;
	}

	public void setLatitude(Double latitude) {
		this.latitude = latitude;
	}

	public String getName() {
		return name;
	}

	public void setName(String name) {
		this.name = name;
	}
}

Beispiel: Füllen der Daten

//Beim Instanziieren muss das DataMapFormat definiert werden
//DataMapFormat.Latitude --> Definition der Orte über "Long" and "Lat"
//DataMapFormat.Address --> Definition der Orte die Adresse z.B. "Mustersweg 16 92224 Musterndorf"
XdevMapChartModel model = new XdevMapChartModel(DataMapFormat.Latitude);

model.addItem(37.4232, -122.0853, "Work");
model.addItem(37.4289, -122.1697, "University");
model.addItem(37.6153, -122.3900, "Airport");
model.addItem(37.4422, -122.1731, "Shopping");

mapChart.setModel(model);

API und Methoden:

Füllen der Daten

model.addItem(String value, String value2, Integer value3)

model.addItem(37.4232, -122.0853, "Work");

//Parameter 1 (37.4232): Latitude
//Parameter 2 (-122.0853): Longitude
//Parameter 3 ("Work"): Beschriftung oder Name des Ortes

Setzen API-Key (erforderlich)

model.addItem(String value, String value2, Integer value3)

XdevMapChart chart = new XdevMapChart("<api-key>");

//oder

XdevMapChart mapChart= new XdevMapChart();
mapChart.setApiKey("<api-key>");

Konfiguration des XdevMapChart

model.addItem(String value, String value2, Integer value3)

XdevMapChartConfig config = new XdevMapChartConfig();

//Mögliche Werte: "normal", "terrain", "satellite", "hybrid";
config.setMapType("normal");
 
config.setEnableScrollWheel(true); //Maouserad für den Mapzoom aktivieren
config.setShowLine(true); //Ländergrenzen anzeigen
config.setLineColor("Red"); //Farbe der Ländergrenzen
config.setLineWidth(5); //Breite der Ländergrenzen
config.setUseMapTypeControl(true); //Aktiviert diverser Controls auf der Map um diese zu steuern. Default: AN
config.setZoomLevel(8); //Initiales Zoomlevel. Werte zwischen 0(Welt) und 19(max.Zoom) sind möglich.