Inhalt:

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
37.4232	-122.0853	"Work"
37.4289	-122.1697	"University"
37.6153	-122.3900	"Airport"
...

oder

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 XdevGeoCharts

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

XdevMapChartConfig config = new XdevMapChartConfig();

Konfiguration Farben

XdevMapChartConfig config = new XdevMapChartConfig();

config.setBackgroundColor(...); //Siehe API Allgemein "BackgroundStyle"

config.setDatalessRegionColor("Red"); //Nicht berücksichtigte Länder oder Regionen werden mit dieser Farbe gekennzeichnet
config.setDefaultColor("White"); //Berücksichtigte Regionen oder Länder die keine explizite Farbe zugewiesen haben bekommen diese Farbe

//Eine Liste an Farben die dann der Reihe nach an die Kategorien vergeben werden
List<String> places = Arrays.asList("#FFFFFF", "Red", "#F4g6uz");
config.setColors(places); //Zuweisen der Farbliste