Inhalt:

Daten- / Objektstruktur
Füllen von Daten
Chartkonfiguration

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):

Beschriftung	X-Axis

Beschriftung	X-Axis
"United States"	327414000
"Japan"	126490000
"Russia"	146877088
...

Optimale Objektstruktur (Java)

public class GeoChartObject {
	private String country;
	private Integer value;

	public String getCountry() {
		return country;
	}

	public void setCountry(String country) {
		this.country = country;
	}

	public Integer getValue() {
		return value;
	}

	public void setValue(Integer value) {
		this.value = value;
	}
}

Beispiel: Füllen der Daten

XdevGeoChartModel model = new XdevGeoChartModel("Country", "Popularity");

model.addItem("United States", 327414000);
model.addItem("Japan", 126490000);
model.addItem("Russia", 146877088);
model.addItem("Botswana", 2304238);
model.addItem("Australia", 24985600);
model.addItem("Canada", 37153100);

API und Methoden:

Füllen der Daten

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

model.addItem("United States", 327414000);

//Parameter 1 ("United States"): Ein valider Länder- oder Städtename
//Parameter 2 (327414000): Benötigter Wert z.B. Einwohner

Hier finden Sie eine Liste aller validen Codes und Countries: Ländercodes

Setzen API-Key (erforderlich)

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

XdevGeoChart geoChart = new XdevGeoChart("<api-key>");

//oder

XdevGeoChart geoChart = new XdevGeoChart();
geoChart.setApiKey("<api-key>");

Konfiguration des XdevGeoCharts

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

XdevGeoChartConfig config = new XdevGeoChartConfig();

//"world" - Ein Chart welches die gesamte Welt anzeigt
//Ein Kontinent oder Subkontinent, definiert über den 3 stelligen Ländercode z.B. "011" für Western Africa.
//Ein Land, definiert über seinen ISO 3166-1 alpha-2, z.B. "AU" für Australien.
config.setRegion("world");

//"auto" - Wählt den Mode automatisch auf Basis der Daten
//"regions" - Färbt die jeweiligen Region ein
//"markers" - Setzt Markierungen auf die Karte
//"text" - Beschriftung der Region mit Werten aus der Storage
config.setDisplayMode("regions"); //

Konfiguration Farben

XdevGeoChartConfig config = new XdevGeoChartConfig();

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