Kartendiagramm (eingestellte Version)

 

Ersatzbenachrichtigung: Dieses Kartendiagramm wurde durch eine neuere Version ersetzt.

Auf dieser Seite wird beschrieben, wie Sie mit der Charts API eine Farbkarte erstellen.

Inhaltsverzeichnis

Diagrammspezifische Funktionen Overview Codes der US-Bundesstaaten

Standardfunktionen Diagrammtitel (chtt, chts) Diagrammränder (chma) Hintergrundfüllung Durchgehende Füllungen (chf)

Übersicht

Sie können eine Karte erstellen, auf der verschiedene Länder oder Bundesstaaten in benutzerdefinierten Farben hervorgehoben sind. Dazu geben Sie an, in welche Region der Welt die Karte herangezoomt werden soll. Außerdem geben Sie eine Liste der Regionen an, die in der Karte eingefärbt werden sollen, und eine parallele Datenliste, in der jedem entsprechenden Land ein numerischer Wert zugewiesen wird. Jedes Land wird entsprechend dem zugewiesenen Wert farblich entlang eines Farbverlaufs dargestellt. Sie können für Datenwerte optional einen benutzerdefinierten Farbverlauf angeben.

In Kartendiagrammen werden die folgenden Parameter unterstützt:

Parameter	Erforderlich oder optional	Beschreibung
cht=t	Erforderlich	Gibt ein Kartendiagramm an.
chs	Erforderlich	Kartengröße. Die maximale Größe einer Karte beträgt 440 x 220 Pixel.
chtm=<zoom_area>	Erforderlich	Im Diagramm dargestellter geografischer Bereich. zoom_area – einer der folgenden Werte africa asia europe middle_east south_america usa world
chld=<country_or_state_codes>	Erforderlich	Eine Liste der Länder oder Bundesstaaten, auf die Sie Werte anwenden. country_or_state code: Hierbei handelt es sich um einen Satz von Codes mit zwei Zeichen ohne Trennzeichen. Verwenden Sie einen der folgenden Typen: Codes nach ISO 3166-1-alpha-2 für Länder oder Codes der US-Bundesstaaten Beispiel: chld=DZEGMG
chd=<country_values>	Erforderlich	Eine Liste von Werten parallel zur Liste der Regionen, wobei der Wert für die entsprechende Region gilt. Werte sind standardmäßig formatierte Datenwerte. Jeder Region wird eine Farbe entlang der in chco angegebenen Skala zugewiesen. Dabei gilt der niedrigste Wert im Bereich für die niedrigste Farbe und der höchste Wert in diesem Bereich für die letzte Farbe. country_values: eine Liste im entsprechenden Formatstring. Beispiele: t:10,20,30, s:aU2Ff und e:BaPoqM-A.
chco=<default_color>,<start_of_gradient>,...,<end_of_gradient>	Optional	Ein Farbbereich, der den niedrigen und hohen Datenwerten für den Datenformatbereich entspricht. Die Datenwerte werden entlang dieses Farbverlaufs in Farbwerte umgewandelt und auf die entsprechenden Länder angewendet. default_color: [optional] Die Farbe von Regionen, denen keine Daten zugewiesen sind. Die Standardeinstellung ist BEBEBE (mittelgrau). Eine Hexadezimalzahl im RRGGBB-Format. start_of_gradient: [start_of_gradient] Die Farbe, die dem Minimalwert im Datenformatbereich entspricht. Der Standardwert ist 0000FF (blau). Eine Hexadezimalzahl im RRGGBB-Format. ... - [Optional] Sie können beliebig viele Zwischenfarben angeben. end_of_gradient: [end_of_gradient] Die Farbe, die dem Maximalwert im Datenformatbereich entspricht. Der Standardwert ist FF0000 (rot). Eine Hexadezimalzahl im RRGGBB-Format.
chtt, chts	Optional	Titel und Stil des Diagramms
chma	Optional	Ränder im Diagramm
chf=bg	Optional	Durchgängige Füllungen (nur Hintergrund)

 

Beispiele

Beschreibung	Beispiel
In diesem Fall gilt Folgendes: Der Zoombereich des Diagramms ist Afrika (chtm=africa). Den drei Ländern werden Werte zugewiesen: Algerien, Ägypten und Madagaskar (chld=DZEGMG) Die drei Werte, die diesen Ländern zugewiesen sind, sind 0, 100 und 50 (chd=t:0,100,50). Dies sind die Mindest-, Höchst- und Mittelwerte für Daten im Textformat. Der Farbbereich ist rot für 0, grün für 100 und Weiß für nicht zugewiesene Länder (chco=FFFFFF,FF0000,00FF00). Das Diagramm hat außerdem eine hellblaue Füllung (chf=bg,s,EAF7FE).	cht=t chtm=africa chld=DZEGMG chd=t:0,100,50 chco=FFFFFF,FF0000,00FF00 chf=bg,s,EAF7FE
Dieses Diagramm ähnelt dem vorherigen, enthält jedoch mehr Details.	chtm=africa chld=DZEGMGAOBWNGCFKECGCVSNDJTZGHMZZM chco=FFFFFF,FF0000,FFFF00,00FF00 chd=t:0,100,50,32,60,40,43,12,14,54,98,17,70,76,18,29 chf=bg,s,EAF7FE
In diesem Diagramm ist zu sehen, dass keine Länder durch Angabe eines einzelnen, nicht definierten Werts (chd=t:-1) hervorgehoben werden.	chs=440x220 chd=t:-1 cht=t chtm=world

Nach oben

Codes der US-Bundesstaaten

Im Folgenden sind die unterstützten Bundesstaatcodes aufgeführt, wenn die Karte auf die USA herangezoomt wird (chld=usa).

AL	Alabama	LA	Louisiana	OH	Ohio
AK	Alaska	ME	Maine	OK	Oklahoma
AZ	Arizona	MD	Maryland	ODER	Oregon
AR	Arkansas	MA	Massachusetts	PA	Pennsylvania
CA	Kalifornien	MI	Michigan	RI	Rhode Island
CO	Colorado	MN	Minnesota	SC	South Carolina
CT	Connecticut	MS	Mississippi	SD	South Dakota
DE	Delaware	MO	Missouri	TN	Tennessee
FL	Florida	MT	Montana	TX	Texas
GA	Georgien	NE	Nebraska	UT	Utah
HI	Hawaii	NV	Nevada	VT	Vermont
ID	Idaho	NACF	New Hampshire	VA	Virginia
IL	Illinois	NJ	New Jersey	WA	Washington
IN	Indiana	NM	New Mexico	WV	West Virginia
IA	Iowa	NY	New York	WI	Wisconsin
KS	Kansas	NC	North Carolina	WY	Wyoming
KY	Kentucky	ND	North Dakota

Nach oben

Standardfunktionen

Bei den übrigen Elementen auf dieser Seite handelt es sich um Standardelemente in Diagrammen.

Diagrammtitel chtt, chts [Alle Diagramme]

Sie können den Titeltext, die Farbe und die Schriftgröße für Ihr Diagramm festlegen.

Syntax

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt: Gibt den Diagrammtitel an.

<chart_title>

Der für das Diagramm anzuzeigende Titel. Sie können nicht festlegen, wo dies angezeigt wird. Sie haben aber die Möglichkeit, die Schriftgröße und -farbe anzugeben. Verwenden Sie ein Pluszeichen, um Leerzeichen anzugeben, und ein senkrechter Strich ( |) für Zeilenumbrüche.

 

chts [optional]: Farben und Schriftgröße für den Parameter chtt.

<color>

Die Titelfarbe im Hexadezimalformat RRGGBB. Die Standardfarbe ist Schwarz.

<font_size>

Schriftgröße des Titels in Punkten.

<opt_alignment>

[Optional] Ausrichtung des Titels. Wählen Sie einen der folgenden Stringwerte aus. Dabei ist auf die Groß- und Kleinschreibung zu achten: „l“ (links), „c“ (mittig) „r“ (rechts). Die Standardeinstellung ist „c“.

 

Beispiele

Beschreibung	Beispiel
Ein Diagramm mit einem Titel, in der Standardfarbe und -schriftgröße verwendet werden. Geben Sie ein Leerzeichen mit einem Pluszeichen (+) ein. Verwenden Sie einen senkrechten Strich (|), um einen Zeilenumbruch zu erzwingen. chts ist hier nicht angegeben.	chtt=Site+visitors+by+month| January+to+July
Ein Diagramm mit einem blauen, rechts ausgerichteten Titel mit 20 Punkten.	chtt=Site+visitors chts=FF0000,20,r

Nach oben

Ränder in Diagramm chma [alle Diagramme]

Sie können die Größe der Ränder des Diagramms in Pixeln angeben. Ränder werden ausgehend von der angegebenen Diagrammgröße (chs) berechnet. Eine Erhöhung der Ränder erhöht nicht die Gesamtgröße des Diagramms, sondern verkleinert gegebenenfalls den Diagrammbereich.

Die Ränder entsprechen standardmäßig dem, was nach der Berechnung der Diagrammgröße übrig bleibt. Dieser Standardwert variiert je nach Diagrammtyp. Die von Ihnen angegebenen Ränder sind ein Mindestwert. Wenn im Diagrammbereich Platz für Ränder bleibt, bleibt die Ränder übrig, die übrig bleibt. Sie können die Ränder nicht kleiner zusammendrücken, als für Legenden und Labels erforderlich ist. Das folgende Diagramm zeigt die grundlegenden Bestandteile eines Diagramms:

Die Ränder des Diagramms umfassen die Achsenlabels und den Legendenbereich. Die Größe des Legendenbereichs wird automatisch an den Text angepasst, es sei denn, Sie geben mit chma eine größere Breite an. In diesem Fall wird der Rand vergrößert und der Diagrammbereich kleiner. Sie können eine Legende nicht durch Angabe einer zu kleinen Größe zuschneiden, Sie können jedoch festlegen, dass sie mehr Platz einnimmt, als erforderlich ist. Tipp: Wenn die Balken in einem Balkendiagramm eine feste Größe (Standardeinstellung) haben, kann die Breite des Diagrammbereichs nicht verringert werden. Sie müssen mit chbh eine kleinere oder anpassbare Balkengröße angeben.

 

Syntax

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>

<left_margin>, <right_margin>, <top_margin>, <bottom_margin>

Minimale Randgröße um den Diagrammbereich in Pixeln Erhöhen Sie diesen Wert, um einen Innenrand hinzuzufügen, damit Achsenbeschriftungen nicht über den Rahmen des Diagramms stoßen.

<opt_legend_width>, <opt_legend_height>

[Optional] Breite des Rands um die Legende in Pixeln. Damit vermeiden Sie, dass die Legende gegen den Diagrammbereich oder die Ränder des Bildes ragt.

 

Beispiele

Beschreibung	Beispiel
In diesem Beispiel hat das Diagramm einen Mindestrand von 30 Pixeln auf jeder Seite. Da die Diagrammlegende mehr als 30 Pixel breit ist, wird der Rand auf der rechten Seite auf die Breite der Diagrammlegende festgelegt und unterscheidet sich von den anderen Rändern. Achsenbeschriftungen befinden sich außerhalb des Diagrammbereichs und werden daher innerhalb des Randbereichs gezeichnet.	chma=30,30,30,30
Wenn Sie einen Rand um die Legende hinzufügen möchten, legen Sie einen Wert für die Parameter <opt_legend_width> und <opt_legend_height> fest. In diesem Beispiel ist die Legende etwa 60 Pixel breit. Wenn Sie die <opt_legend_width> auf 80 Pixel festlegen, erweitert sich der Rand bis zu 20 Pixel außerhalb der Legende.	chma=20,20,20,30|80,20

Nach oben

Hintergrundfüllungen chf [alle Diagramme]

Sie können Füllfarben und -stile für den Datenbereich des Diagramms und/oder den gesamten Diagrammhintergrund angeben. Zu den Fülltypen gehören durchgehende Füllungen, gestreifte Füllungen und Farbverläufe. Sie können unterschiedliche Füllungen für verschiedene Bereiche angeben, z. B. den gesamten Diagrammbereich oder nur den Datenbereich. Die Füllung des Diagrammbereichs überschreibt die Hintergrundfüllung. Alle Füllungen werden mit dem Parameter chf angegeben. Sie können verschiedene Fülltypen (Festkörper, Streifen, Farbverläufe) im selben Diagramm mischen, indem Sie die Werte durch ein Pipe-Zeichen ( | ) trennen. Diagrammflächenfüllungen überschreiben Füllungen im Diagrammhintergrund.

Durchgängige Füllungen chf [alle Diagramme]

Sie können eine durchgehende Füllung für den Hintergrund und/oder den Diagrammbereich angeben oder dem gesamten Diagramm einen Transparenzwert zuweisen. Mit dem senkrechten Strich (|) können Sie mehrere Füllungen angeben (Maps: nur Hintergrund).

Syntax

chf=<fill_type>,s,<color>|...

<fill_type>

Der Teil des Diagramms, der ausgefüllt wird. Geben Sie einen der folgenden Werte an:

• bg – Hintergrundfüllung
• c: Flächenfüllung des Diagramms. Diese Option wird für Kartendiagramme nicht unterstützt.
• a: Das gesamte Diagramm einschließlich der Hintergründe transparent machen. Die ersten sechs Ziffern von <color> werden ignoriert und nur die letzten beiden (der Transparenzwert) werden auf das gesamte Diagramm und alle Füllungen angewendet.
• b<index>: ausgefüllte Balken (nur Balkendiagramme) Ersetzen Sie <index> durch den Reihenindex der Balken, die mit einer Volltonfarbe gefüllt werden sollen. Der Effekt ähnelt der Angabe von chco in einem Balkendiagramm. Ein Beispiel finden Sie unter Farben für Balkendiagrammreihen.

s

Gibt eine durchgehende Füllung oder eine transparente Füllung an.

<color>

Die Füllfarbe im Hexadezimalformat RRGGBB. Bei Transparenzen werden die ersten sechs Ziffern ignoriert, müssen aber trotzdem angegeben werden.

 

Beispiele

Beschreibung	Beispiel
In diesem Beispiel wird der Diagrammhintergrund mit einem hellen Grau gefüllt (EFEFEF).	chf=bg,s,EFEFEF
In diesem Beispiel wird der Diagrammhintergrund mit einem hellen Grau (EFEFEF) gefüllt und der Diagrammbereich schwarz (000000).	chf=c,s,000000| bg,s,EFEFEF
In diesem Beispiel wird eine Transparenz von 50% auf das gesamte Diagramm angewendet (80 im hexadezimalen Wert entspricht 128 oder etwa 50% Transparenz). Beachten Sie, dass der Hintergrund der Tabellenzelle durch das Diagramm durchscheint.	chf=a,s,00000080

Nach oben

Farbformat

Sie können Farben mithilfe einer sechsstelligen Zeichenfolge mit Hexadezimalwerten sowie zwei optionalen Transparenzwerten im Format RRGGBB[AA] angeben. Beispiel:

• FF0000 = Rot
• 00FF00 = Grün
• 0000FF = Blau
• 000000 = Schwarz
• FFFFFF = Weiß

AA ist ein optionaler Transparenzwert, wobei 00 vollständig transparent und FF vollständig undurchsichtig ist. Beispiel:

• 0000FFFF = Durchgehend blau
• 0000FF66 = Transparentblau

Nach oben