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 |
Standardfunktionen
|
Ü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.
|
chld=<country_or_state_codes> |
Erforderlich | Eine Liste der Länder oder Bundesstaaten, auf die Sie Werte anwenden.
Beispiel: |
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.
|
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.
|
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:
|
|
Dieses Diagramm ähnelt dem vorherigen, enthält jedoch mehr Details. |
chtm=africa |
In diesem Diagramm ist zu sehen, dass keine Länder durch Angabe eines einzelnen, nicht definierten Werts ( |
chs=440x220 |
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 |
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 ( Verwenden Sie einen senkrechten Strich (
|
chtt=Site+visitors+by+month| |
Ein Diagramm mit einem blauen, rechts ausgerichteten Titel mit 20 Punkten. |
chtt=Site+visitors |
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 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 |
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. |
|
Wenn Sie einen Rand um die Legende hinzufügen möchten, legen Sie einen Wert für die Parameter In diesem Beispiel ist die Legende etwa 60 Pixel breit. Wenn Sie die |
|
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üllungc
: 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 vonchco
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 ( |
|
In diesem Beispiel wird der Diagrammhintergrund mit einem hellen Grau ( |
|
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. |
|
Sie können Farben mithilfe einer sechsstelligen Zeichenfolge mit Hexadezimalwerten sowie zwei optionalen Transparenzwerten im Format RRGGBB[AA]
angeben.
Beispiel:
FF0000
= Rot00FF00
= Grün0000FF
= Blau000000
= SchwarzFFFFFF
= Weiß
AA
ist ein optionaler Transparenzwert, wobei 00
vollständig transparent und FF
vollständig undurchsichtig ist. Beispiel:
0000FFFF
= Durchgehend blau0000FF66
= Transparentblau