Kartendiagramm (eingestellte Version)

 

Änderungsbenachrichtigung: Dieses Kartendiagramm wurde durch eine neuere Version ersetzt.

Auf dieser Seite wird beschrieben, wie Sie mithilfe der Charts API eine farbige Karte erstellen.

Inhaltsverzeichnis

Diagrammspezifische Funktionen Übersicht Codes für US-Bundesstaaten

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

Übersicht

Sie können eine Karte erstellen, auf der verschiedene Länder oder Bundesstaaten in benutzerdefinierten Farben hervorgehoben sind. Zum Angeben einer Karte geben Sie an, in welche Region der Welt die Karte herangezoomt werden soll. Außerdem geben Sie eine Liste der Regionen an, die auf der Karte eingefärbt werden sollen, sowie eine parallele Datenliste, die jedem entsprechenden Land einen numerischen Wert zuweist. Jedes Land wird entsprechend dem ihm zugewiesenen Wert in einem Farbverlauf eingefärbt. Sie können optional einen benutzerdefinierten Farbverlauf für Datenwerte 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.
chtm=<zoom_area>	Erforderlich	Der im Diagramm dargestellte geografische 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 Staaten, auf die Sie Werte anwenden. country_or_state-Codes: Dies sind zweistellige Codes ohne Trennzeichen. Verwenden Sie einen der folgenden Typen (Sie können diese nicht mischen): ISO 3166-1-alpha-2-Codes 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 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 festlegen. 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	Diagrammränder
chf=bg	Optional	Undurchsichtige 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 bzw. 50 (chd=t:0,100,50). Dies sind die Mindest-, Höchst- und Mittelwerte für Textformatdaten. 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 Hintergrundfü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 Diagramm, enthält aber 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
Dieses Diagramm zeigt an, dass durch die Angabe eines einzelnen, nicht definierten Werts (chd=t:-1) keine Länder hervorgehoben werden.	chs=440x220 chd=t:-1 cht=t chtm=world

Nach oben

Codes für US-Bundesstaaten

Dies sind die unterstützten Bundesstaatencodes, wenn die Karte auf die USA (chld=usa) vergrößert wird.

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	Georgia	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	KE	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 restlichen Funktionen auf dieser Seite handelt es sich um Standarddiagrammelemente.

Diagrammtitel chtt, chts [Alle Diagramme]

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

Syntax

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

 

chtt: Gibt den Diagrammtitel an.

<chart_title>

Titel, der für das Diagramm angezeigt werden soll. Sie können nicht festlegen, wo der Text erscheinen soll. Sie haben aber die Möglichkeit, die Schriftgröße und -farbe festzulegen. Verwenden Sie ein Pluszeichen für Leerzeichen und einen senkrechten Strich ( |) für Zeilenumbrüche.

 

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

<color>

Die Titelfarbe im RRGGBB-Hexadezimalformat. 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, wobei die Groß- und Kleinschreibung beachtet werden muss: "l" (links), "c" (zentriert) "r" (rechts). Der Standardwert ist „c“.

 

Beispiele

Beschreibung	Beispiel
Ein Diagramm mit einem Titel in Standardfarbe und -schriftgröße. Geben Sie ein Leerzeichen mit einem Pluszeichen (+) an. 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, rechtsbündigen Titel mit 20 Punkten.	chtt=Site+visitors chts=FF0000,20,r

Nach oben

Diagrammränder chma [Alle Diagramme]

Sie können die Größe der Ränder des Diagramms in Pixeln festlegen. Die Ränder werden ausgehend von der angegebenen Diagrammgröße (chs) nach innen berechnet (chs); beim Erhöhen der Ränder wird nicht die Gesamtgröße des Diagramms erhöht, sondern bei Bedarf wird der Diagrammbereich verkleinert.

Die Ränder sind standardmäßig derjenige, der 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 Ränder vorhanden sind, entspricht die Randgröße dem Rest, der übrig bleibt. Sie können die Ränder nicht zusammendrücken, die kleiner als für Legenden und Beschriftungen sind. Hier ist ein Diagramm, das die grundlegenden Teile eines Diagramms zeigt:

Die Diagrammränder umfassen die Achsenbeschriftungen 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 wird kleiner. Sie können eine Legende nicht durch Angabe einer zu kleinen Größe zuschneiden. Sie können aber dafür sorgen, dass sie mehr Platz einnimmt. Tipp: Wenn die Balken in einem Balkendiagramm eine feste Größe haben (Standardeinstellung), kann die Breite des Diagrammbereichs nicht verringert werden. Mit chbh müssen Sie 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>

Mindestränder im Diagrammbereich in Pixeln Erhöhen Sie diesen Wert, um etwas Abstand einzufügen, damit sich die Achsenlabels nicht über den Rahmen des Diagramms bewegen.

<opt_legend_width>, <opt_legend_height>

[Optional] Breite des Rands um die Legende in Pixeln. So vermeiden Sie, dass die Legende über den Diagrammbereich oder die Bildränder hinausragt.

 

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 <opt_legend_width> auf 80 Pixel setzen, wird der Rand auf 20 Pixel außerhalb der Legende erweitert.	chma=20,20,20,30|80,20

Nach oben

Hintergrundfüllung chf [Alle Diagramme]

Sie können Füllfarben und -stile für den Diagrammdatenbereich und/oder den gesamten Diagrammhintergrund festlegen. Fülltypen umfassen durchgängige Füllungen, gestreifte Füllungen und Farbverläufe. Sie können verschiedene 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 (Durchgänge, Streifen, Farbverläufe) im selben Diagramm mischen. Dazu trennen Sie die Werte durch einen senkrechten Strich ( | ). Füllungen des Diagrammbereichs überschreiben die Hintergrundfüllung des Diagramms.

Durchgängige Füllung chf [Alle Diagramme]

Sie können eine durchgängige Füllung für den Hintergrund und/oder den Diagrammbereich angeben oder dem gesamten Diagramm einen Transparenzwert zuweisen. Mit dem senkrechten Strich (|) können mehrere Füllungen angegeben werden (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: Diagrammbereich wird ausgefüllt. Nicht unterstützt für Kartendiagramme.
• a: Das gesamte Diagramm (einschließlich der Hintergründe) wird transparent gemacht. Die ersten sechs Ziffern von <color> werden ignoriert und nur die letzten beiden Ziffern (der Transparenzwert) werden auf das gesamte Diagramm und alle Füllungen angewendet.
• b<index>: ausgefüllte Balken (nur Balkendiagramme) Ersetzen Sie <index> durch den Serienindex der Balken, die mit einer Volltonfarbe gefüllt werden sollen. Dies ähnelt der Angabe von chco in einem Balkendiagramm. Ein Beispiel finden Sie unter Farben für Balkendiagrammreihen.

s

Kennzeichnet eine ausgefüllte Füllung oder eine transparente Füllung.

<color>

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

 

Beispiele

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

Nach oben

Farbformat

Geben Sie Farben mit einem sechsstelligen String aus Hexadezimalwerten sowie zwei optionalen Transparenzwerten im Format RRGGBB[AA] an. 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 deckend ist. Beispiel:

• 0000FFFF = Durchgehend blau
• 0000FF66 = Blau transparent

Nach oben