Карта-диаграмма (устаревшая версия)

Предупреждение о замене : Эта диаграмма-карта была заменена более новой версией .

На этой странице описано, как создать цветную карту с помощью API диаграмм.

Оглавление

Особенности диаграммы Обзор Коды штатов США

Стандартные функции Название диаграммы ( chtt , chts ) Поля диаграммы ( chma ) Фоновая заливка Сплошная заливка ( chf )

Обзор

Вы можете создать карту, на которой различные страны или штаты будут выделены произвольными цветами. Чтобы указать карту, вы укажете, к какому региону мира карта должна приближаться. Вы также укажете список регионов, которые должны быть раскрашены на карте, и параллельный список данных, который присваивает числовое значение каждой соответствующей стране. Каждая страна окрашена градиентом в соответствии с присвоенным ей значением. При желании вы можете указать собственный цветовой градиент для значений данных.

Карты-диаграммы поддерживают следующие параметры:

Параметр	Обязательный или необязательный	Описание
cht=t	Необходимый	Определяет диаграмму карты.
chs	Необходимый	Размер карты. Максимальный размер карты — 440x220.
chtm=< zoom_area >	Необходимый	Географическая область, показанная на схеме. Zoom_area — одно из следующих значений africa asia europe middle_east south_america usa world
chld=< country_or_state_codes >	Необходимый	Список стран или штатов, к которым вы применяете значения. Коды страны_или_штата — это набор двухсимвольных кодов без разделителя между ними. Используйте любой из следующих типов (нельзя смешивать типы): Коды стран ISO 3166-1-альфа-2 или Коды штатов США Пример: chld=DZEGMG
chd=< country_values >	Необходимый	Список значений, параллельный списку регионов, где значение применяется к соответствующему региону. Значения представляют собой значения данных в стандартном формате . Каждому региону будет присвоен цвет по шкале, указанной в chco , где самое низкое значение в диапазоне применяется к самому низкому цвету, а самое высокое значение в этом диапазоне применяется к последнему цвету. Country_values ​​— список в строке соответствующего формата. Примеры: t:10,20,30 , s:aU2Ff и e:BaPoqM-A .
chco=< default_color >,< start_of_gradient >,...,< end_of_gradient >	Необязательный	Диапазон цветов, соответствующий нижнему и верхнему значениям данных для диапазона формата данных. Значения данных преобразуются в значения цвета по этому градиенту и применяются к соответствующим странам. default_color — [ Необязательно ] Цвет регионов, которым не назначены данные. По умолчанию — BEBEBE (средне-серый). Шестнадцатеричное число в формате RRGGBB . start_of_gradient — [ Необязательно ] Цвет, соответствующий минимальному значению в диапазоне формата данных. Значение по умолчанию — 0000FF (синий). Шестнадцатеричное число в формате RRGGBB . ... - [ Необязательно ] Вы можете использовать столько промежуточных цветов, сколько захотите. end_of_gradient — [ Необязательно ] Цвет, соответствующий максимальному значению в диапазоне формата данных. По умолчанию — FF0000 (красный). Шестнадцатеричное число в формате RRGGBB.
chtt, chts	Необязательный	Название и стиль диаграммы
chma	Необязательный	Поля диаграммы
chf=bg	Необязательный	Сплошная заливка (только фон)

Примеры

Описание	Пример
В этом примере: Область масштабирования диаграммы — Африка ( chtm=africa ). Трем странам будут присвоены значения: Алжир, Египет и Мадагаскар ( chld=DZEGMG ). Этим странам присвоены три значения: 0, 100 и 50 соответственно ( chd=t:0,100,50 ), которые являются минимальным, максимальным и средним значениями для данных текстового формата. Диапазон цветов: красный для 0, зеленый для 100 и белый для неназначенных стран ( chco=FFFFFF,FF0000,00FF00 ). Диаграмма также имеет светло-голубую заливку фона ( chf=bg,s,EAF7FE ).	cht=t chtm=africa chld=DZEGMG chd=t:0,100,50 chco=FFFFFF,FF0000,00FF00 chf=bg,s,EAF7FE
Эта диаграмма аналогична предыдущей, но более детальна.	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
На этой диаграмме указано, что ни одна страна не выделена, путем указания одного неопределенного значения ( chd=t:-1 ).	chs=440x220 chd=t:-1 cht=t chtm=world

Вернуться наверх

Коды штатов США

Вот поддерживаемые коды штатов при увеличении карты до США ( chld=usa ).

АЛ	Алабама	Лос-Анджелес	Луизиана	ОЙ	Огайо
АК	Аляска	МНЕ	Мэн	ХОРОШО	Оклахома
AZ	Аризона	доктор медицинских наук	Мэриленд	ИЛИ	Орегон
АР	Арканзас	МА	Массачусетс	Пенсильвания	Пенсильвания
Калифорния	Калифорния	МИ	Мичиган	РИ	Род-Айленд
СО	Колорадо	Миннесота	Миннесота	СК	Южная Каролина
Коннектикут	Коннектикут	РС	Миссисипи	СД	Северная Дакота
DE	Делавэр	МО	Миссури	ТН	Теннесси
Флорида	Флорида	МТ	Монтана	Техас	Техас
Джорджия	Грузия	СВ	Небраска	ЮТ	Юта
ПРИВЕТ	Гавайи	НВ	Невада	ВТ	Вермонт
ИДЕНТИФИКАТОР	Айдахо	Нью-Хэмпшир	Нью-Гемпшир	Вирджиния	Вирджиния
Иллинойс	Иллинойс	Нью-Джерси	Нью-Джерси	Вашингтон	Вашингтон
В	Индиана	Нью-Мексико	Нью-Мексико	Западная Вирджиния	Западная Виргиния
Я	Айова	Нью-Йорк	Нью-Йорк	Висконсин	Висконсин
КС	Канзас	Северная Каролина	Северная Каролина	Вайоминг	Вайоминг
Кентукки	Кентукки	без даты	Северная Дакота

Вернуться наверх

Стандартные функции

Остальные функции на этой странице являются стандартными функциями диаграмм.

Название графика chtt , chts [ Все графики ]

Вы можете указать текст заголовка, цвет и размер шрифта для диаграммы.

Синтаксис

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

chtt — указывает заголовок диаграммы.

< название_диаграммы >

Название для отображения диаграммы. Вы не можете указать, где это будет отображаться, но при желании вы можете указать размер и цвет шрифта. Используйте знак + для обозначения пробелов и символ вертикальной черты ( | ) для обозначения разрывов строк.

chts [ Необязательно ] — цвета и размер шрифта для параметра chtt .

<цвет >

Цвет заголовка в шестнадцатеричном формате RRGGBB . Цвет по умолчанию — черный.

<размер_шрифта >

Размер шрифта заголовка, в пунктах.

<opt_alignment>

[ Необязательно ] Выравнивание заголовка. Выберите одно из следующих строковых значений с учетом регистра: «l» (слева), «c» (по центру), «r» (справа). По умолчанию — «с».

Примеры

Описание	Пример
Диаграмма с заголовком, использующая цвет и размер шрифта по умолчанию. Укажите пробел со знаком плюс ( + ). Используйте символ вертикальной черты ( | ), чтобы вызвать разрыв строки. chts здесь не указан.	chtt=Site+visitors+by+month| January+to+July
Диаграмма с синим заголовком размером 20 пунктов, выровненным по правому краю.	chtt=Site+visitors chts=FF0000,20,r

Вернуться наверх

Поля диаграммы chma [ Все диаграммы ]

Вы можете указать размер полей диаграммы в пикселях. Поля рассчитываются внутрь от указанного размера диаграммы ( chs ); Увеличение размера поля не увеличивает общий размер диаграммы, а, при необходимости, уменьшает ее область.

Поля по умолчанию — это все, что осталось после расчета размера диаграммы. Это значение по умолчанию зависит от типа диаграммы. Указанные вами поля являются минимальным значением; если в области диаграммы остается место для полей, размер поля будет таким же, как и оставшееся; вы не можете сжимать поля меньше, чем требуется для любых легенд и надписей. Вот диаграмма, показывающая основные части диаграммы:

Поля диаграммы включают метки осей и область легенды . Размер области легенды изменяется автоматически, чтобы точно соответствовать тексту, если только вы не укажете большую ширину с помощью chma , и в этом случае размер поля увеличится, сжимая область диаграммы меньше. Вы не можете обрезать легенду, указав слишком маленький размер, но можете заставить ее занимать больше места, чем необходимо. Совет: Если в гистограмме столбцы имеют фиксированный размер (по умолчанию), ширину области диаграммы нельзя уменьшить. Вы должны указать меньший или изменяемый размер полосы с помощью chbh .

Синтаксис

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

< левое_поле >, < правое_поле >, < верхнее_поле >, < нижнее_поле >

Минимальный размер поля вокруг области диаграммы в пикселях. Увеличьте это значение, чтобы включить некоторые отступы, чтобы метки осей не сталкивались с границами диаграммы.

<opt_legend_width> , <opt_legend_height>

[ Необязательно ] Ширина поля вокруг легенды в пикселях. Используйте это, чтобы легенда не сталкивалась с областью диаграммы или краями изображения.

Примеры

Описание	Пример
В этом примере диаграмма имеет минимальное поле в 30 пикселей с каждой стороны. Поскольку ширина легенды диаграммы превышает 30 пикселей, поле справа устанавливается на ширину легенды диаграммы и отличается от других полей. Метки осей находятся за пределами области графика и поэтому рисуются внутри поля.	chma=30,30,30,30
Чтобы добавить поле вокруг легенды, установите значение для параметров < opt_legend_width > и < opt_legend_height > . В этом примере ширина легенды составляет примерно 60 пикселей. Если вы установите для < opt_legend_width > значение 80 пикселей, поле расширится до 20 пикселей за пределами легенды.	chma=20,20,20,30|80,20

Вернуться наверх

Фоновые заливки chf [ Все графики ]

Вы можете указать цвета и стили заливки для области данных диаграммы и/или всего фона диаграммы. К типам заливок относятся сплошные заливки, полосатые заливки и градиенты. Вы можете указать разные заливки для разных областей (например, всей области диаграммы или только области данных). Заливка области диаграммы перезаписывает заливку фона. Все заливки задаются с помощью параметра chf , и вы можете смешивать разные типы заливок (сплошные, полосатые, градиенты) на одной диаграмме, разделяя значения вертикальной чертой ( | ). Заливки области диаграммы перезаписывают заливки фона диаграммы.

Сплошные заливки chf [ Все графики ]

Вы можете указать сплошную заливку для фона и/или области диаграммы или назначить значение прозрачности для всей диаграммы. Вы можете указать несколько заливок, используя символ вертикальной черты ( | ). (Карты: только фон).

Синтаксис

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

< тип_заполнения >

Заполняемая часть диаграммы. Укажите одно из следующих значений:

• bg — заливка фона
• c - Заливка области диаграммы. Не поддерживается для картографических диаграмм.
• a . Сделайте всю диаграмму (включая фон) прозрачной. Первые шесть цифр < color > игнорируются, и только последние две (значение прозрачности) применяются ко всей диаграмме и всем заливкам.
• b <index> — столбчатая сплошная заливка (только гистограммы). Замените <index> индексом серии столбцов, чтобы залить их сплошным цветом. Эффект аналогичен указанию chco на гистограмме. Пример см. в разделе «Цвета серии гистограмм» .

с

Указывает сплошную или прозрачную заливку.

< цвет >

Цвет заливки в шестнадцатеричном формате RRGGBB . Для прозрачных пленок первые шесть цифр игнорируются, но их все равно необходимо включить.

Примеры

Описание	Пример
В этом примере фон диаграммы заливается бледно-серым цветом ( EFEFEF ).	chf=bg,s,EFEFEF
В этом примере фон диаграммы заливается бледно-серым цветом ( EFEFEF ), а область диаграммы заливается черным ( 000000 ).	chf=c,s,000000| bg,s,EFEFEF
В этом примере ко всей диаграмме применяется прозрачность 50 % (80 в шестнадцатеричном формате равно 128, или прозрачность около 50 %). Обратите внимание на фон ячейки таблицы, просвечивающий через диаграмму.	chf=a,s,00000080

Вернуться наверх

Цветовой формат

Укажите цвета, используя 6-значную строку шестнадцатеричных значений плюс два необязательных значения прозрачности в формате RRGGBB[ AA ] . Например:

• FF0000 = Красный
• 00FF00 = Зеленый
• 0000FF = Синий
• 000000 = Черный
• FFFFFF = Белый

AA — необязательное значение прозрачности, где 00 — полностью прозрачный, а FF — полностью непрозрачный. Например:

• 0000FFFF = сплошной синий
• 0000FF66 = Прозрачный синий

Вернуться наверх