Карта Диаграммы

На этой странице описано, как создать цветную карту с помощью API диаграмм. Эта диаграмма представляет собой новую улучшенную версию, которая поддерживает карту большего размера и больше функций, чем старая диаграмма-карта ( cht=t ).

Оглавление

Особенности диаграммы Обзор Поддерживаемые параметры Масштабирование и центрирование

Стандартные функции Название диаграммы ( chtt , chts ) Цвета диаграммы ( chco ) Поля диаграммы ( chma ) Фоновая заливка Сплошная заливка ( chf ) Легенды диаграмм ( chdl, Chdlp ) Маркеры формы ( chm ) Маркеры текста и данных ( chm )

Обзор

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

Поддерживаемые параметры

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

Параметр	Обязательный или необязательный	Описание
cht=map< opt_zoom_and_center >	Необходимый	Определяет диаграмму карты. opt_zoom_and_center — необязательная строка, позволяющая масштабировать или центрировать диаграмму в определенном регионе. Смотрите подробности .
chs	Необходимый	Размер карты. Максимальные размеры карты — 600 пикселей в ширину, 600 пикселей в высоту или всего 300 000 пикселей.
chd= < first_country_value >, ..., < last_country_value >	Необязательный	Если используется, значение данных будет указывать цвет соответствующей страны в соответствии с цветовым градиентом, указанным chco .
chld= < country_or_region_codes >|...|	Необходимый	Список стран и штатов, разделенных вертикальной чертой, которые будут выделены цветами, заданными chco . Карта автоматически масштабируется и включает в себя все указанные страны, если вы не выполните пользовательское масштабирование или центрирование . Коды должны быть в верхнем регистре. Эти коды представляют собой коды ISO 3166-1-alpha-2 : два символа верхнего регистра, за которыми необязательно следует тире, и второй идентификатор региона или города. Примеры: GB (Великобритания), GB-LND (Лондон), US-NJ (штат Нью-Джерси в США).
chco Если chd не используется: chco= < unselected_land_color >| < first_region_color >| ...| < last_region_color > Если используется chd : chco= < unselected_land_color >, < color_range_start >, ..., < color_range_end >	Необязательный	Цвета диаграммы. Формат этой строки зависит от того, используете ли вы chd . В обоих синтаксисах < unselected_land_color > — это цвет любых регионов, не указанных в chld . Обратите внимание, что разделители для разных синтаксисов разные (запятые в одном, каналы в другом). Если этот параметр не используется, регионы будут выделены контуром, но не окрашены. chd Used — второй и последующие цвета описывают цветовой диапазон. У вас должно быть одно значение chd для каждой страны в chld , и соответствующая страна будет окрашена в диапазоне от <first_region_color > (минимальное значение диапазона данных) до < last_region_color > (максимальное значение диапазона данных). См. примеры в таблице ниже. chd не используется — второй и последующие цвета применяются к соответствующим областям в chld в указанном порядке. Если стран больше, чем цветов, ко всем лишним странам в списке будет применен последний цвет.
chtt, chts	Необязательный	Название и стиль диаграммы
chm	Необязательный	Маркеры диаграммы
chma	Необязательный	Поля диаграммы
chf=bg...	Необязательный	Сплошная заливка (только фон)
chdl	Необязательный	Легенды диаграмм

Примеры

Описание	Пример
В этом примере: cht=map:fixed=-60,0,80,-35 — область масштабирования карты составляет от -60 до 80 широты, от 0 до -35 долготы. chld=CA-BC|CN|IT|GR|US-UT – выделены следующие регионы: Британская Колумбия, Китай, Италия, Гриз и Юта. chm — маркеры диаграммы для флагов. chma=0,110,0,0 — правая граница увеличена до 110 пикселей, чтобы правильно соответствовать легенде. chtt=Last+Five+Olympic+Hosts — заголовок диаграммы, где + используется для обозначения пробелов.	cht=map:fixed=-60,0,80,-35 chs=600x350 chld=CA-BC|CN|IT|GR|US-UT chdl=Vancouver|Beijing|Torino|Athens|Salt+Lake+City chco=B3BCC0|5781AE|FF0000|FFC726|885E80|518274 chtt=Last+Five+Olympic+Hosts chm=f2010+Winter,000000,0,0,10 f2008+Summer,000000,0,1,10 f2008+Winter,000000,0,2,10,1,:-5:10 f2004+Summer,000000,0,3,10 f2004+Summer,000000,0,4,10 chma=0,110,0,0
Карта Франции с выделенными двумя регионами: chld=FR-D|FR-B|FR — указаны три региона: Бургундия (на востоке), Аквитания (на юго-западе) и Франция. chco=676767|FF4444|44FF44|4444FF — в этой карте не указан параметр chd , поэтому каждое значение цвета после первого используется для указания соответствующей страны. Красный для Бургундии, зеленый для Аквитании, синий для Франции. Вы можете видеть, что более поздние цвета не маскируют более ранние цвета.	chld=FR-D|FR-B|FR chco=676767|FF4444|44FF44|4444FF
Эта карта демонстрирует использование цветовых градиентов. chd=t:0,50,100 — параметр chd указывает цветовой градиент. Здесь указывается кодировка текста, которая имеет диапазон от 0 до 100. chco=CCCCCC,FF0000,000000 — цвет фона светло-серый ( CCCCCC ), а цветовой диапазон — от красного ( FF0000 ) до черного ( 000000 ). Показанная средняя страна является промежуточным цветом в этом градиенте.	chd=t:0,50,100 chco=CCCCCC,FF0000,000000
Обратите внимание, что карту можно обрезать в пределах указанного размера диаграммы. Это связано с тем, что мы не искажаем карту, чтобы она соответствовала указанному размеру диаграммы, а ограничиваем карту областями, которые вы указываете в chld. Поэтому, чтобы избежать обрезки областей внутри границ диаграммы, вам, возможно, придется настроить размер карты вручную.	cht=map chs=300x300 chld=GB Англия по своей природе длинная и тонкая, поэтому при указании квадратной карты с правой стороны будет обрезана область: cht=map chs=180x300 chld=GB Отрегулируйте ширину диаграммы, чтобы обрезать лишнее. Обратите внимание, что внизу все еще есть обрезка, которую следует исправить, уменьшив высоту карты. cht=map chs=180x300 chld=GB Франция имеет гораздо более правильную форму, поэтому она более естественно вписывается в квадратную карту.

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

Масштабирование и центрирование

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

По пикселям

Чтобы настроить границы по размеру пикселей, используйте этот формат:

cht=map:auto=<left_border>,<right_border>,<top_border>,<bottom_border>

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

Вы можете только уменьшить масштаб (положительные значения); вы не можете увеличить масштаб (отрицательные значения) ближе, чем уровень масштабирования по умолчанию, используя масштабирование по пикселям.

Примеры:

Все эти примеры показывают Лондон (лат.

Без масштабирования (по умолчанию)	Уменьшено на 30 пикселей с каждой стороны.	Уменьшение и уменьшение вправо
cht=map	cht=map:auto=30,30,30,30	cht=map:auto=50,0,80,0

По широте и долготе

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

cht=map:fixed=<bottom_border_lat>,<left_border_long>,<top_border_lat>,<right_border_long>

Где <bottom_border_lat> и <top_border_lat> определяют широту нижней и верхней границ, а <left_border_long> и <right_border_long> определяют долготу левой и правой границ.

Примечание. Из-за искажения проекции Меркатора (по сути, проецирования изогнутой карты на плоское изображение) фокусировка на высокой узкой полосе может привести к неожиданным различиям в размерах вашей карты.

Примеры:

В следующих примерах показан Лондон (выделен синим цветом) с координатами 0,1° долготы и 51,5° широты. Обратите внимание, что происходит обрезка карты, поскольку карта пытается отобразить только Великобританию (как указано) и заполнить указанную диаграмму без искажений.

Центрировано	Широта сдвинута на +10*	Увеличено путем уменьшения всех значений.
cht=map:fixed=40,-10,60,10	cht=map:fixed=50,-10,70,10	cht=map:fixed=48,-3,54,3

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

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

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

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

Название графика 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

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

Текст и стиль легенды диаграммы chdl , chdlp , chdls [ Все диаграммы ]

Легенда — это боковая часть диаграммы, содержащая небольшое текстовое описание каждой серии. Вы можете указать текст, связанный с каждой серией в этой легенде, и указать, где на диаграмме он должен появиться.

См. также chma , чтобы узнать, как установить поля вокруг легенды.

Примечание о строковых значениях: в строках меток разрешены только символы, безопасные для URL. В целях безопасности вам следует закодировать URL-адресом все строки, содержащие символы, не входящие в набор символов 0-9a-zA-Z . Кодировщик URL-адресов можно найти в документации по визуализации Google .

Синтаксис

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

chdl — текст каждой серии для отображения в легенде.

< метка_серии_данных >

Текст для записей легенды. Каждая метка применяется к соответствующей серии в массиве chd . Используйте знак + для пробела. Если вы не укажете этот параметр, на диаграмме не будет легенды. Невозможно указать разрыв строки в метке. Легенда обычно расширяется, чтобы вместить текст легенды, а область диаграммы сжимается, чтобы вместить легенду.

chdlp — [ необязательно ] Положение легенды и порядок записей легенды. Вы можете указать <position> и/или <label_order> . Если вы укажете оба, разделите их чертой. Вы можете добавить «s» к любому значению, если хотите, чтобы пустые записи легенды в chdl были пропущены в легенде. Примеры: chdlp=bv , chdlp=r , chdlp=bv|r , chdlp=bvs|r

< опт_позиция >

[ Необязательно ] Указывает положение легенды на диаграмме. Чтобы указать дополнительное отступы между легендой и областью диаграммы или границей изображения, используйте параметр chma . Выберите одно из следующих значений:

• b – Легенда внизу диаграммы, записи легенды расположены в горизонтальном ряду.
• bv — легенда внизу диаграммы, записи легенды в вертикальном столбце.
• t — Легенда вверху диаграммы, записи легенды расположены в горизонтальном ряду.
• tv — Легенда вверху диаграммы, записи легенды в вертикальном столбце.
• r — [ по умолчанию ] Легенда справа от диаграммы, записи легенды в вертикальном столбце.
• l — Легенда слева от диаграммы, записи легенды в вертикальном столбце.

<opt_label_order>

[ Необязательно ] Порядок отображения меток в легенде. Выберите одно из следующих значений:

• l [ По умолчанию для вертикальных легенд ] Отображать метки в порядке, указанном в chdl .
• r — отображать метки в порядке, обратном заданному chdl . Это полезно в составных гистограммах, чтобы показать легенду.
  в том же порядке, в котором появляются полосы.
• a — [ По умолчанию для горизонтальных легенд ] Автоматическое упорядочение: примерно означает сортировку по длине, сначала самый короткий, измеряемый в блоках по 10 пикселей. Если два элемента имеют одинаковую длину (разделены на блоки по 10 пикселей), первым будет отображаться тот, который указан первым.
• 0,1,2... — Пользовательский порядок меток. Это список индексов меток, отсчитываемых от нуля, из chdl , разделенных запятыми.

chdls — [ необязательно ] Задает цвет и размер шрифта текста легенды.

< цвет >

Цвет текста легенды в шестнадцатеричном формате RRGGBB .

< размер >

Размер пункта текста легенды.

Примеры

Описание	Пример
Два примера легенд. Укажите текст легенды в том же порядке, что и ряд данных.	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
На первой диаграмме показаны записи горизонтальной легенды ( chdlp=t , макет по умолчанию — горизонтальный), а на второй — нижние записи вертикальной легенды ( chdlp=bv ).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
В этом примере показано изменение размера шрифта.	chdls=0000CC,14

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

Маркеры формы chm [ Пистолет, Линия, Радар, Разброс ]

Вы можете указать графические маркеры для всех или отдельных точек данных на диаграмме. Если два или более маркера занимают одну и ту же точку, маркеры рисуются в том порядке, в котором они указаны в параметре chm . Вы также можете создавать текстовые маркеры для точек данных, которые описаны в разделе «Маркеры точек данных» .

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

Синтаксис

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

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

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>

@

[ Необязательно ] Если перед типом маркера стоит необязательный символ @, то < opt_what_points > должен использовать формат x:y .

<тип_маркера>

Тип используемого маркера. Укажите один из следующих типов:

• a - Стрелка
• c - Крест
• C – Прямоугольник. Если это прямоугольный маркер, у вас должно быть как минимум две серии данных, где серия 0 указывает нижний край, а серия 1 — верхний край. < размер > определяет ширину прямоугольника в пикселях.
• d - Алмаз
• E - Маркер полосы ошибок ( ) Для создания этого маркера требуется два ряда данных: одно значение для нижнего уровня и соответствующая точка во втором ряду для верхнего. Он также предоставляет расширенный синтаксис <size> : line_thickness [: top_and_bottom_width ], где top_and_bottom_width является необязательным. См. примеры ниже.
• h — горизонтальная линия на диаграмме на указанной высоте. ( Единственный допустимый формат для параметра <opt_that_points> — nd . )
• H — Горизонтальная линия, проходящая через указанный маркер данных. Поддерживается расширенный синтаксис <size> , который позволяет указать точную длину линии: line_thickness [: length ] где : length не является обязательным и по умолчанию соответствует полной ширине области диаграммы.
• o - Круг
• s - Квадрат
• v — Вертикальная линия от оси X до точки данных.
• V – Вертикальная линия регулируемой длины. Это поддерживает расширенный синтаксис значения <size> , который позволяет указать точную длину линии: line_thickness [: length ] где : length является необязательным и по умолчанию соответствует полной высоте области диаграммы. Маркер располагается в центре точки данных.
• x - Ан Х

< цвет >

Цвет маркеров для этой серии в шестнадцатеричном формате RRGGBB .

< индекс_серии >

Отсчитываемый от нуля индекс ряда данных, на котором будут рисоваться маркеры. Игнорируется для маркеров h и маркеров, которые указывают местоположение по положению x/y (начинаются с символа @). Вы можете использовать скрытые ряды данных в качестве источника маркеров; дополнительную информацию см. в разделе «Составные диаграммы» . Сгруппированные вертикальные гистограммы поддерживают специальный расширенный синтаксис для выравнивания маркеров по определенным столбцам.

< opt_what_points >

[ Необязательно ] На каких точках рисовать маркеры. По умолчанию — все маркеры. Используйте одно из следующих значений:

• nd — Где нарисовать маркер. Значение зависит от типа маркера:
  • Все типы, кроме h — на какой точке данных рисовать маркер, где nd — индекс в серии, отсчитываемый от нуля. Если вы укажете нецелое значение, то дробь указывает на рассчитанную промежуточную точку. Например, 3,5 означает середину между точкой 3 и точкой 4.
  • h — число от 0,0 до 1,0, где 0,0 — низ диаграммы, а 1,0 — верх диаграммы.
• -1 — Нарисуйте маркер на всех точках данных. Вы также можете оставить этот параметр пустым, чтобы использовать все точки данных.
• - n - Нарисовать маркер на каждой n -й точке данных. Значение с плавающей запятой; если n меньше 1, график рассчитает для вас дополнительные промежуточные точки. Например, при значении -0,5 маркеров будет в два раза больше, чем точек данных.
• start:end:n — рисует маркер на каждой n -й точке данных в диапазоне, от начального до конечного значения индекса включительно. Все параметры являются необязательными (могут отсутствовать), поэтому 3::1 будет от четвертого элемента до последнего, шаг 1, а полный пропуск этого параметра по умолчанию будет равен first : last :1. Все значения могут быть числами с плавающей запятой. начало и конец могут быть отрицательными, чтобы вести отсчет в обратном направлении от последнего значения. Если и начало , и конец отрицательны, убедитесь, что они указаны в возрастающем значении (например, -6:-1:1). Если значение n шага меньше 1, дополнительные точки данных будут рассчитаны путем интерполяции заданных значений данных. Значения по умолчанию: первый:последний:1.
• x : y — Нарисуйте маркер в определенной точке x/y на графике. Эта точка не обязательно должна находиться на прямой. Чтобы использовать эту опцию, добавьте символ @ перед типом маркера. Укажите координаты в виде значений с плавающей запятой, где 0:0 — левый нижний угол диаграммы, а 1:1 — правый верхний угол диаграммы. Например, чтобы добавить красный ромб размером 15 пикселей в центр диаграммы, используйте @d,FF0000,0,0.5:0.5,15 .

< размер >

Размер маркера в пикселях. Большинство из них принимают для этого параметра одно числовое значение; Маркеры V, H и S поддерживают синтаксис < size >[: width ], где необязательная вторая часть указывает длину строки или маркера.

< opt_z_order >

[ Необязательно ] Слой, на котором будет рисоваться маркер, по сравнению с другими маркерами и всеми остальными элементами диаграммы. Это число с плавающей запятой от -1,0 до 1,0 включительно, где -1,0 — низ, а 1,0 — верх. Элементы диаграммы (линии и столбцы) чуть ниже нуля. Если два маркера имеют одинаковое значение, они отображаются в порядке, заданном URL-адресом. Значение по умолчанию — 0,0 (чуть выше элементов диаграммы).

<opt_offset>

[ Необязательно ] Позволяет указать горизонтальное и вертикальное смещение от указанного местоположения. Вот синтаксис, в котором используется : разделитель: reserved :< horizontal_offset >:< vertical_offset > . Если указано, вы можете включить пустое значение в строку параметра chm для <opt_z_order> . Примеры: o,FF9900,0,4,12,, :10 o,FF9900,0,4,12.0,, :-10:20 o,FF9900,0,4,12,1, ::20

• зарезервировано – оставьте пустым.
• < horizontal_offset > — положительное или отрицательное число, определяющее горизонтальное смещение в пикселях. Необязательный; оставьте пустым, если не используется.
• < vertical_offset > — положительное или отрицательное число, определяющее вертикальное смещение в пикселях. Необязательный; оставьте пустым, если не используется.

Примеры

Описание	Пример
Вот пример нескольких маркеров формы и линий. a,990066,0,0.0,9.0 — Фиолетовая стрелка, первая серия, первая точка, размер 9. c,FF0000,0,1.0,20.0 — Красный крест, первая серия, вторая точка, размер 9. d,80C65A,0,2,20.0 - Зеленый ромб, первая серия, третья точка, размер 9. H,000000,0,3,1:40 — черная горизонтальная линия, первая серия, точка данных 3, ширина один пиксель, длина сорок пикселей. o,FF9900,0,4.0,12.0 — Оранжевый кружок, первая серия, пятая точка, размер 12. s,3399CC,0,5.0,11.0 — Синий квадрат, первый ряд, шестая точка, размер 11. v,BBCCED,0,6.0,1.0 — Вертикальная линия до точки, первая серия, седьмая точка, ширина в один пиксель. V,3399CC,0,7.0,1.0 — Вертикальная линия снизу вверх диаграммы, первая серия, восьмая точка, ширина в один пиксель. x,FFCC33,0,8.0,20.0 — желтый «X», первая серия, девятая точка, размер 20. H,FFFF00,0,9,2 — горизонтальная желтая линия шириной диаграммы в точке данных 9. h,FF0000,0,0.5,1 — красная горизонтальная линия на заданной высоте, первая серия, посередине диаграммы, шириной в один пиксель.	chm= a,990066,0,0.0,9.0| c,FF0000,0,1.0,20| d,80C65A,0,2.0,20.0| H,000000,0,3,1:40| o,FF9900,0,4.0,12.0| s,3399CC,0,5.0,11.0| v,BBCCED,0,6,1.0| V,3399CC,0,7,1.0| x,FFCC33,0,8,20| H,FFFF00,0,9,2| h,FF0000,0,0.5,1
Вот пример использования ромбов для одного ряда данных и кружков для другого ряда данных. Если два или более маркера занимают одну и ту же точку, маркеры рисуются в том порядке, в котором они указаны в параметре chm . Здесь круг — это первый маркер, указанный с помощью chm , поэтому он рисуется первым. Ромб указывается и рисуется вторым, в результате чего он рисуется поверх круга.	chm= o,FF9900,0,-1,15.0| d,FF0000,1,-1,10.0
Вот линейный график с маркером на каждой второй точке данных (-2 означает каждую вторую точку).	chd=t: 0,20,20,50,40,70,70,90,85,45,40,50 chm= o,0066FF,0,-2,6
Вот линейный график, на котором маркеров в два раза больше, чем точек данных (-0,5 означает каждую половину точки).	chd=t: 0,20,20,50,40,70,70,90,85,45,40,50 chm= o,0066FF,0,-.5,6
В этом примере показано, как использовать маркеры h и v для создания линий сетки произвольного цвета и толщины. Значение z-порядка (последнее значение) установлено на -1, чтобы линии сетки рисовались под линией данных.	chm= h,76A4FB,0,0:1:.2,2,-1| V,76A4FB,0,::2,0.5,-1
На этой диаграмме к линейному графику добавляются вертикальные линии заливки: v - Вертикальные линии на графике FF0000 — Красные линии 0 — индекс серии : :.5 — Спецификатор диапазона: от начала до конца, каждые 0,5 пункта. 2 - Толщина 2 пикселя.	chm= v,FF0000,0,::.5,2
В этом примере на диаграмму добавляется стрелка и текстовый маркер с использованием точных координат. Первый маркер D — это линия трассировки под столбиками. Второй маркер — это стрелка, а третий маркер — текст стрелки.	chm= D,003971,1,0,3| @a,000000,0,.25:.75,7| @tExpected,000000,0,.35:.85,10
Горизонтальная линия, привязанная к определенной точке данных ( H ), может быть полезна для отображения относительных значений или выделения высоты значения данных на диаграмме.	chm=H,FF0000,0,18,1
На этом графике показаны маркеры, которые могут указывать толщину и длину линии в параметре <size> . E,000000,0,6,1:20 — черная полоса ошибок с линиями шириной 1 пиксель, верхней и нижней полосами длиной 20 пикселей. Низ привязан к серии 0 точка 8, верх привязан к серии 1 точка 8. H,990066,1,2,5:50 — фиолетовая горизонтальная линия шириной пять пикселей и длиной пятьдесят пикселей с центром в точке данных 2. V,3399CC,0,8,3:50 — синяя вертикальная линия шириной 3 пикселя и длиной пятьдесят пикселей, с центром в точке данных 8.	title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50%7CV,3399CC,0,8,3:50% 7CE,000000,0,6,1:20" src="/chart/image/images/chart_95.png" /> chm= E,000000,0,6,1:20| H,990066,1,2,5:50| V,3399CC,0,8,3:50

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

Маркеры значений текста и данных chm [ столбец, линия, радар, разброс ]

Вы можете пометить определенные точки на диаграмме собственным текстом или отформатированными версиями данных в этой точке.

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

Примечание о строковых значениях: в строках меток разрешены только символы, безопасные для URL. В целях безопасности вам следует закодировать URL-адресом все строки, содержащие символы, не входящие в набор символов 0-9a-zA-Z . Кодировщик URL-адресов можно найти в документации по визуализации Google .

Синтаксис

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

chm=
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
    |...|
  <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>

<тип_маркера>

Тип используемого маркера. Вы можете выбрать следующие типы:

• f<text> — флаг, содержащий текст. Укажите символ «f», за которым следует текст в кодировке пользовательского URL-адреса. Чтобы избежать запятых в текстовых маркерах, поставьте перед запятой знак \. Пример: fHello\,+World!
• t<text> — простой текстовый маркер. Укажите символ «t», за которым следует пользовательский текст в кодировке URL. Чтобы избежать запятых в текстовых маркерах, поставьте перед запятой знак \. Пример: tHello\,+World!
• A< text > — маркер аннотации. Это похоже на маркер-флаг, но маркеры согласовывают свое положение, чтобы не перекрываться. Единственный допустимый формат для <opt_that_points> — это nd , обозначающий индекс точки в серии.
• N< formatting_string > — значение данных на данный момент с необязательным форматированием. Если вы не используете параметр chds (настраиваемое масштабирование), он дает точное закодированное значение; если вы используете этот параметр с любым типом формата, значение будет масштабироваться до указанного вами диапазона. См. пример chds с числовыми маркерами ниже. При использовании этого типа маркера на составной гистограмме , если вы укажете -1 для <series_index> , вы получите маркер, показывающий сумму всех значений на этой составной гистограмме. Синтаксис строки форматирования следующий:
  < preceding_text >*< number_type >< decimal_places >zs< x or y >*< following_text > .
  Все эти элементы являются необязательными. Вот значение каждого элемента:
  • <preceding_text> — текст, предшествующий каждому значению.
  • *...* — необязательный блок, заключенный в буквенные звездочки, в котором можно указать детали форматирования чисел. Следующие значения поддерживаются и являются необязательными:
    • <number_type> — числовой формат для числовых значений. Выберите один из следующих вариантов:
      • f - [ По умолчанию ] Формат с плавающей запятой. Рассмотрите также возможность указать точность с помощью значения < decimal_places >.
      • p — процентный формат. Знак % добавляется автоматически. Примечание. При использовании этого формата значения данных от 0,0 до 1,0 преобразуются в значения от 0 до 100 % (например, 0,43 будет отображаться как 43 %).
      • e - Формат научной записи.
      • c< CUR > — форматирует число в указанной валюте с соответствующим маркером валюты. Замените < CUR > трехбуквенным кодом валюты. Пример: cEUR для евро. Список кодов можно найти на веб-сайте ISO , хотя поддерживаются не все символы.
    • <decimal_places> — целое число, определяющее количество отображаемых десятичных знаков. Значение округляется (не усекается) до этой длины. По умолчанию — 2.
    • z — отображать конечные нули. По умолчанию нет .
    • s — Отобразить разделители групп. По умолчанию нет .
    • x или y — отображение данных по координатам x или y, как указано. Значение данных x зависит от типа диаграммы: поэкспериментируйте с диаграммой, чтобы определить, что они означают. По умолчанию — «y» .
  • < following_text > — текст, следующий за каждым значением.

< цвет >

Цвет маркеров для этого набора в шестнадцатеричном формате RRGGBB .

< индекс_серии >

Отсчитываемый от нуля индекс ряда данных, на котором будут рисоваться маркеры. Если это составная гистограмма и тип маркера — N (значения точек данных), вы можете указать -1, чтобы создать маркер суммированного значения для каждой стопки столбцов. См. пример ниже.

< opt_what_points >

[ Необязательно ] На каких точках рисовать маркеры. По умолчанию — все маркеры. Используйте одно из следующих значений:

• nd — на какой точке данных рисовать маркер, где nd — индекс в ряду, отсчитываемый от нуля. Если вы укажете нецелое значение, то дробь указывает на рассчитанную промежуточную точку. Например, 3,5 означает середину между точкой 3 и точкой 4.
• -1 — Нарисуйте маркер на всех точках данных. Вы также можете оставить этот параметр пустым, чтобы использовать все точки данных.
• -n — Нарисовать маркер на каждой n -й точке данных.
• start : end : n — рисует маркер на каждой n -й точке данных в диапазоне, от начального до конечного значения индекса включительно. Все параметры являются необязательными (могут отсутствовать), поэтому 3::1 будет от четвертого элемента до последнего, шаг 1, а полный пропуск этого параметра по умолчанию будет равен first : last :1. Все значения могут быть числами с плавающей запятой. начало и конец могут быть отрицательными, чтобы вести отсчет в обратном направлении от последнего значения. Если и начало , и конец отрицательны, убедитесь, что они указаны в возрастающем значении (например, -6:-1:1). Если значение n шага меньше 1, дополнительные точки данных будут рассчитаны путем интерполяции заданных значений данных. Значения по умолчанию: первый:последний:1.
• x : y - [ Не поддерживается для маркеров типа N ] Нарисуйте маркер в определенной точке x/y на диаграмме. Эта точка не обязательно должна находиться на прямой. Чтобы использовать эту опцию, добавьте символ at ( @ ) перед типом маркера. Укажите координаты в виде значений с плавающей запятой, где 0:0 — левый нижний угол диаграммы, 0.5:0.5 — центр диаграммы, а 1:1 — правый верхний угол диаграммы. Например, чтобы добавить красный ромб размером 15 пикселей в центр диаграммы, используйте @d,FF0000,0,0.5:0.5,15 .

< размер >

Размер маркера в пикселях. Если это точечная диаграмма с третьим рядом данных (используется для указания размеров точек), это значение будет масштабироваться в соответствии с диапазоном данных. Таким образом, если диапазон данных составляет 0–100, а < размер > равен 30, значение данных 100 будет иметь ширину 30 пикселей, значение данных 50 будет иметь ширину 15 пикселей и т. д.

< opt_z_order >

[ Необязательно ] Слой, на котором будет рисоваться маркер, по сравнению с другими маркерами и всеми остальными элементами диаграммы. Это число с плавающей запятой от -1,0 до 1,0 включительно, где -1,0 — низ, а 1,0 — верх. Элементы диаграммы (линии и столбцы) чуть ниже нуля. Если два маркера имеют одинаковое значение, они отображаются в порядке, заданном URL-адресом. Значение по умолчанию — 0,0 (чуть выше элементов диаграммы).

<opt_placement>

[ Необязательно ] Дополнительные сведения о размещении, описывающие, где разместить этот маркер относительно точки данных. Вы можете указать горизонтальное и/или вертикальное относительное позиционирование, а также смещения. Синтаксис размещения представляет собой строку с разделителями :, как показано здесь. Все элементы являются необязательными: < horizontal_and_vertical_justification >:< horizontal_offset >:< vertical_offset > . Если указано, вы можете включить пустое значение в строку параметра chm для <opt_z_order> . Примеры: N,000000,0,1,10,,b и N,000000,0,1,10,,lv и N,000000,0,1,10,,r::10 .

Horizontal_and_vertical_justification

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

• Горизонтальное размещение : «l», «h» или «r» — привязка слева, по центру или справа, горизонтально. По умолчанию — «л».
• Вертикальное размещение : «b», «v», «t» — крепление снизу, посередине или сверху, вертикально. По умолчанию — «б».
• Размещение относительно столбца [ только для гистограмм] : «s», «c», «e» — основание, центр или верх столбца. Для составных диаграмм это относится к разделу столбца для каждой серии, а не ко всему столбцу. Если указанный индекс серии равен -1 (общее количество стопок), это относится ко всему стержню. Это можно комбинировать со значениями вертикального размещения: например, «be» или «vs». Значение по умолчанию — «е».

горизонтальное_смещение

Горизонтальное смещение этого маркера в пикселях. По умолчанию — 0.

вертикальное_смещение

Вертикальное смещение этого маркера в пикселях. По умолчанию для гистограммы: 15; гистограмма диаграмма по умолчанию: 2 .

Описание	Пример
Ниже приведен пример меток значений на гистограмме. Первая диаграмма ( N*p0* ) определяет маркер значения данных, где значения отображаются в процентах, округленные до нуля десятичных знаков, черным цветом, для всех значений, текстом размером 11 пунктов. Обратите внимание, что все значения данных находятся в диапазоне от 0,0 до 1,0, что в процентном формате сдвигается вверх на два знака после запятой. На второй диаграмме ( N*cEUR1* ) показаны те же значения, отформатированные как значения евро, один десятичный знак, черным цветом, для всех значений, текстом размером 11 пунктов.	chm= N*p0*,000000,0,-1,11 chd=t: 0.4356,0.3562,0.4834,0.575,0.673,0.6091 chm= N*cEUR1*,000000,0,-1,11
Вы можете использовать параметр chds для масштабирования отображаемого числового значения. Вы можете использовать chds для всех форматов данных, включая простое и расширенное кодирование. Это не повлияет на размер полосы или метки осей, а только на значение маркера данных. В этом примере показана диаграмма со значениями простой кодировки 46, 39, 29, 30, 43, 41. Диапазон простого кодирования — 0–61. Параметр chds определяет пользовательский масштаб маркера от 0 до 1, поэтому значения маркеров масштабируются до этого диапазона, но высота столбцов не затрагивается (если бы это были данные в текстовом формате , столбцы также масштабировались бы).	chd=s:underp chm=N,000000,0,-1,11 chds=0,1
Вот пример диаграммы с текстовой меткой в ​​минимальной точке и меткой-флажком в максимальной точке.	chm= tMin,0000FF,0,1,10| fMax,FF0000,0,3,15
В этом примере показана составная диаграмма со значениями для отдельных серий, а также итоговой суммой серии. Чтобы отобразить значения сложенных рядов, мы должны использовать опцию позиционирования «c»; если бы мы этого не сделали, значение верхней полосы перекрывало бы значение суммы в верхней части каждой полосы.	chm= N,FF0000,-1,,12| N,000000,0,,12,,c| N,000000,1,,12,,c| N,ffffff,2,,12,,c
Еще несколько демонстраций того, как работает вертикальное и горизонтальное размещение. В этом примере демонстрируются различные комбинации значений привязки для гистограмм (которые используют s, c и e для вертикального размещения). Обратите внимание, как правая привязка перемещает маркер влево, а верхняя привязка перемещает маркер вниз, и наоборот. Красные точки показывают основание, центр и верх каждого столбца. Число — это значение данных, фиксированное с использованием разных значений привязки для каждого столбца.	chm= N,000000,0,0,10,,rs N,000000,0,1,10,,ls N,000000,0,2,10,,c N,000000,0,3,10,,e N,000000,0,4,10,,e::15 N,000000,0,5,10,,e::-12
Маркеры аннотаций автоматически корректируют положение меток, чтобы они не перекрывались. Первое значение chm предназначено для заполнения строки, все следующие значения — это маркеры аннотаций.	chm=B,C5D4B5BB,0,0,0 AA,666666,0,3,15 AB,666666,0,5,15 AC,666666,0,24,15 AD,666666,0,25,15 AE,666666,0,26,15 AF,666666,0,51,15 AG,666666,0,60,15 AH,666666,0,73,15 AI,666666,0,80,15 AJ,666666,0,99,15
Еще один пример маркера аннотации, демонстрирующий высоту города в Швейцарии.

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