Предупреждение о замене : Эта диаграмма-карта была заменена более новой версией .
На этой странице описано, как создать цветную карту с помощью API диаграмм.
Оглавление
Особенности диаграммы | Стандартные функции
|
Обзор
Вы можете создать карту, на которой различные страны или штаты будут выделены произвольными цветами. Чтобы указать карту, вы укажете, к какому региону мира карта должна приближаться. Вы также укажете список регионов, которые должны быть раскрашены на карте, и параллельный список данных, который присваивает числовое значение каждой соответствующей стране. Каждая страна окрашена градиентом в соответствии с присвоенным ей значением. При желании вы можете указать собственный цветовой градиент для значений данных.
Карты-диаграммы поддерживают следующие параметры:
Параметр | Обязательный или необязательный | Описание |
---|---|---|
cht=t | Необходимый | Определяет диаграмму карты. |
chs | Необходимый | Размер карты. Максимальный размер карты — 440x220. |
chtm=< zoom_area > | Необходимый | Географическая область, показанная на схеме.
|
chld=< country_or_state_codes > | Необходимый | Список стран или штатов, к которым вы применяете значения.
Пример: |
chd=< country_values > | Необходимый | Список значений, параллельный списку регионов, где значение применяется к соответствующему региону. Значения представляют собой значения данных в стандартном формате . Каждому региону будет присвоен цвет по шкале, указанной в chco , где самое низкое значение в диапазоне применяется к самому низкому цвету, а самое высокое значение в этом диапазоне применяется к последнему цвету.
|
chco=< default_color >,< start_of_gradient >,...,< end_of_gradient > | Необязательный | Диапазон цветов, соответствующий нижнему и верхнему значениям данных для диапазона формата данных. Значения данных преобразуются в значения цвета по этому градиенту и применяются к соответствующим странам.
|
chtt, chts | Необязательный | Название и стиль диаграммы |
chma | Необязательный | Поля диаграммы |
chf=bg | Необязательный | Сплошная заливка (только фон) |
Примеры
Описание | Пример |
---|---|
В этом примере:
|
|
Эта диаграмма похожа на предыдущую, но более детальна. | chtm=africa |
На этой диаграмме указано, что ни одна страна не выделена, путем указания одного неопределенного значения ( | chs=440x220 |
Коды штатов США
Вот поддерживаемые коды штатов при увеличении карты до США ( chld=usa
).
АЛ | Алабама | Лос-Анджелес | Луизиана | ОЙ | Огайо |
АК | Аляска | МНЕ | Мэн | ХОРОШО | Оклахома |
AZ | Аризона | доктор медицинских наук | Мэриленд | ИЛИ | Орегон |
АР | Арканзас | МА | Массачусетс | Пенсильвания | Пенсильвания |
Калифорния | Калифорния | МИ | Мичиган | РИ | Род-Айленд |
СО | Колорадо | Миннесота | Миннесота | СК | Южная Каролина |
Коннектикут | Коннектикут | РС | Миссисипи | СД | Северная Дакота |
DE | Делавэр | МО | Миссури | ТН | Теннесси |
Флорида | Флорида | МТ | Монтана | Техас | Техас |
Джорджия | Грузия | СВ | Небраска | ЮТ | Юта |
ПРИВЕТ | Гавайи | НВ | Невада | ВТ | Вермонт |
ИДЕНТИФИКАТОР | Айдахо | Нью-Хэмпшир | Нью-Гемпшир | Вирджиния | Вирджиния |
Иллинойс | Иллинойс | Нью-Джерси | Нью-Джерси | Вашингтон | Вашингтон |
В | Индиана | Нью-Мексико | Нью-Мексико | Западная Вирджиния | Западная Виргиния |
Я | Айова | Нью-Йорк | Нью-Йорк | Висконсин | Висконсин |
КС | Канзас | Северная Каролина | Северная Каролина | Вайоминг | Вайоминг |
Кентукки | Кентукки | без даты | Северная Дакота |
Стандартные функции
Остальные функции на этой странице являются стандартными функциями диаграмм.
Название графика chtt
, chts
[ Все графики ]
Вы можете указать текст заголовка, цвет и размер шрифта для диаграммы.
Синтаксис
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
— указывает заголовок диаграммы.
- < название_диаграммы >
- Название для отображения диаграммы. Вы не можете указать, где это будет отображаться, но при желании вы можете указать размер и цвет шрифта. Используйте знак + для обозначения пробелов и символ вертикальной черты (
|
) для обозначения разрывов строк.
chts
[ Необязательно ] — цвета и размер шрифта для параметра chtt
.
- <цвет >
- Цвет заголовка в шестнадцатеричном формате RRGGBB . Цвет по умолчанию — черный.
- <размер_шрифта >
- Размер шрифта заголовка, в пунктах.
- <opt_alignment>
- [ Необязательно ] Выравнивание заголовка. Выберите одно из следующих строковых значений с учетом регистра: «l» (слева), «c» (по центру), «r» (справа). По умолчанию — «с».
Примеры
Описание | Пример |
---|---|
Диаграмма с заголовком, в которой используется цвет и размер шрифта по умолчанию. Укажите пробел со знаком плюс ( Используйте символ вертикальной черты ( | chtt=Site+visitors+by+month| |
Диаграмма с синим заголовком размером 20 пунктов, выровненным по правому краю. | chtt=Site+visitors |
Поля диаграммы chma
[ Все диаграммы ]
Вы можете указать размер полей диаграммы в пикселях. Поля рассчитываются внутрь от указанного размера диаграммы ( chs
); Увеличение размера поля не увеличивает общий размер диаграммы, а, при необходимости, уменьшает ее область.
Поля по умолчанию — это все, что осталось после расчета размера диаграммы. Это значение по умолчанию зависит от типа диаграммы. Указанные вами поля являются минимальным значением; если в области диаграммы остается место для полей, размер поля будет таким же, как и оставшееся; вы не можете сжимать поля меньше, чем требуется для любых легенд и надписей. Вот диаграмма, показывающая основные части диаграммы:
Поля диаграммы включают метки осей и область легенды . Размер области легенды изменяется автоматически, чтобы точно соответствовать тексту, если вы не укажете большую ширину с помощью Совет: Если в гистограмме столбцы имеют фиксированный размер (по умолчанию), ширину области диаграммы нельзя уменьшить. Вы должны указать меньший или изменяемый размер полосы с помощью |
Синтаксис
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- < левое_поле >, < правое_поле >, < верхнее_поле >, < нижнее_поле >
- Минимальный размер поля вокруг области диаграммы в пикселях. Увеличьте это значение, чтобы включить некоторые отступы, чтобы метки осей не сталкивались с границами диаграммы.
- <opt_legend_width> , <opt_legend_height>
- [ Необязательно ] Ширина поля вокруг легенды в пикселях. Используйте это, чтобы легенда не сталкивалась с областью диаграммы или краями изображения.
Примеры
Описание | Пример |
---|---|
В этом примере диаграмма имеет минимальное поле в 30 пикселей с каждой стороны. Поскольку ширина легенды диаграммы превышает 30 пикселей, поле справа устанавливается на ширину легенды диаграммы и отличается от других полей. Метки осей находятся за пределами области графика и поэтому рисуются внутри поля. |
|
Чтобы добавить поле вокруг легенды, установите значение для параметров В этом примере ширина легенды составляет примерно 60 пикселей. Если вы установите для |
|
Фоновые заливки chf
[ Все графики ]
Вы можете указать цвета и стили заливки для области данных диаграммы и/или всего фона диаграммы. К типам заливок относятся сплошные заливки, полосатые заливки и градиенты. Вы можете указать разные заливки для разных областей (например, всей области диаграммы или только области данных). Заливка области диаграммы перезаписывает заливку фона. Все заливки задаются с помощью параметра chf
, и вы можете смешивать различные типы заливок (сплошные, полосатые, градиенты) на одной диаграмме, разделяя значения вертикальной чертой ( | ). Заливки области диаграммы перезаписывают заливки фона диаграммы.
Сплошная заливка chf
[ Все графики ]
Вы можете указать сплошную заливку для фона и/или области диаграммы или назначить значение прозрачности для всей диаграммы. Вы можете указать несколько заливок, используя символ вертикальной черты ( |
). (Карты: только фон).
Синтаксис
chf=<fill_type>,s,<color>|...
- < тип_заполнения >
- Заполняемая часть диаграммы. Укажите одно из следующих значений:
-
bg
— заливка фона -
c
- Заливка области диаграммы. Не поддерживается для картографических диаграмм. -
a
. Сделайте всю диаграмму (включая фон) прозрачной. Первые шесть цифр< color >
игнорируются, и только последние две (значение прозрачности) применяются ко всей диаграмме и всем заливкам. -
b <index>
— столбчатая сплошная заливка (только гистограммы). Замените <index> индексом серии столбцов, чтобы залить их сплошным цветом. Эффект аналогичен указаниюchco
на гистограмме. Пример см. в разделе «Цвета серии гистограмм» .
-
- с
- Указывает сплошную или прозрачную заливку.
- < цвет >
- Цвет заливки в шестнадцатеричном формате RRGGBB . Для прозрачных пленок первые шесть цифр игнорируются, но их все равно необходимо включить.
Примеры
Описание | Пример |
---|---|
В этом примере фон диаграммы заливается бледно-серым цветом ( | |
В этом примере фон диаграммы заливается бледно-серым цветом ( | |
В этом примере ко всей диаграмме применяется прозрачность 50 % (80 в шестнадцатеричном формате равно 128, или прозрачность около 50 %). Обратите внимание на фон ячейки таблицы, просвечивающий через диаграмму. | |
Укажите цвета, используя 6-значную строку шестнадцатеричных значений плюс два необязательных значения прозрачности в формате RRGGBB[ AA ]
. Например:
-
FF0000
= Красный -
00FF00
= Зеленый -
0000FF
= Синий -
000000
= Черный -
FFFFFF
= Белый
AA
— необязательное значение прозрачности, где 00
— полностью прозрачный, а FF
— полностью непрозрачный. Например:
-
0000FFFF
= сплошной синий -
0000FF66
= Прозрачный синий