نمودار نقشه (نسخه منسوخ شده)

هشدار جایگزینی : این نمودار نقشه با نسخه جدیدتر جایگزین شده است.

در این صفحه نحوه ایجاد یک نقشه رنگی با استفاده از Charts 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-alpha-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 ) آمده است.

AL	آلاباما	لس آنجلس	لوئیزیانا	اوه	اوهایو
AK	آلاسکا	من	مین	خوب	اوکلاهما
AZ	آریزونا	MD	مریلند	یا	اورگان
AR	آرکانزاس	MA	ماساچوست	PA	پنسیلوانیا
CA	کالیفرنیا	MI	میشیگان	RI	رود آیلند
CO	کلرادو	MN	مینه سوتا	SC	کارولینای جنوبی
سی تی	کانکتیکات	ام‌اس	می سی سی پی	SD	داکوتای جنوبی
DE	دلاور	MO	میسوری	TN	تنسی
FL	فلوریدا	MT	مونتانا	TX	تگزاس
GA	گرجستان	NE	نبراسکا	UT	یوتا
سلام	هاوایی	NV	نوادا	VT	ورمونت
شناسه	آیداهو	NH	نیوهمپشایر	VA	ویرجینیا
IL	ایلینوی	NJ	نیوجرسی	WA	واشنگتن
که در	ایندیانا	NM	نیومکزیکو	WV	ویرجینیای غربی
IA	آیووا	NY	نیویورک	WI	ویسکانسین
KS	کانزاس	NC	کارولینای شمالی	WY	وایومینگ
KY	کنتاکی	ND	داکوتای شمالی

بازگشت به بالا

ویژگی های استاندارد

بقیه ویژگی های این صفحه ویژگی های نمودار استاندارد هستند.

عنوان نمودار chtt , chts [ همه نمودارها ]

می توانید متن عنوان، رنگ و اندازه قلم را برای نمودار خود مشخص کنید.

نحو

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

chtt - عنوان نمودار را مشخص می کند.

< چارت_عنوان >

عنوانی که باید برای نمودار نشان داده شود. شما نمی توانید مشخص کنید که کجا ظاهر شود، اما می توانید به صورت اختیاری اندازه و رنگ فونت را مشخص کنید. برای نشان دادن فاصله ها از علامت + و برای نشان دادن شکستگی ها از کاراکتر لوله ( | ) استفاده کنید.

chts [ اختیاری ] - رنگ ها و اندازه قلم برای پارامتر chtt .

<رنگ >

رنگ عنوان، در قالب هگزادسیمال RRGGBB . رنگ پیش فرض مشکی است.

<font_size >

اندازه قلم عنوان، بر حسب امتیاز.

< opt_alignment >

[ اختیاری ] تراز عنوان. یکی از مقادیر رشته حساس به حروف بزرگ زیر را انتخاب کنید: "l" (چپ)، "c" (مرکز) "r" (راست). پیش فرض "c" است.

مثال ها

شرح	مثال
نموداری با عنوان، با استفاده از رنگ و اندازه فونت پیش‌فرض. یک فاصله با علامت مثبت ( + ) مشخص کنید. از یک کاراکتر لوله ( | ) برای اجبار شکستن خط استفاده کنید. 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>

< margin_left >، < right_margin >، < top_margin >، < bottom_margin >

حداقل اندازه حاشیه در اطراف منطقه نمودار، بر حسب پیکسل. برای جلوگیری از برخورد برچسب‌های محور با مرزهای نمودار، این مقدار را افزایش دهید تا مقداری بالشتک اضافه شود.

< 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 مشخص می‌شوند و می‌توانید انواع مختلف پر (جامد، راه راه، گرادیان) را با جدا کردن مقادیر با کاراکتر لوله ( | ) در یک نمودار ترکیب کنید. ناحیه نمودار پر می شود پرهای پس زمینه نمودار را بازنویسی می کند.

Solid Fills chf [ همه نمودارها ]

می‌توانید برای پس‌زمینه و/یا ناحیه نمودار یک پرکننده جامد مشخص کنید، یا یک مقدار شفافیت به کل نمودار اختصاص دهید. با استفاده از کاراکتر pipe ( | ) می توانید چندین پر را مشخص کنید. (نقشه ها: فقط پس زمینه).

نحو

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

< fill_type >

بخشی از نمودار در حال پر شدن یکی از مقادیر زیر را مشخص کنید:

• bg - پر کردن پس زمینه
• c - پر کردن منطقه نمودار. برای نمودارهای نقشه پشتیبانی نمی شود.
• a - کل نمودار (از جمله پس زمینه) را شفاف کنید. شش رقم اول < color > نادیده گرفته می شود و تنها دو رقم آخر (مقدار شفافیت) به کل نمودار و همه پرها اعمال می شود.
• b <index> - پرهای جامد میله ای (فقط نمودارهای میله ای). برای پر شدن با یک رنگ ثابت، < index > را با شاخص سری میله ها جایگزین کنید. این اثر شبیه به تعیین chco در نمودار میله ای است. برای مثال رنگ های سری نمودار میله ای را ببینید.

س

پر شدن جامد یا شفاف را نشان می دهد.

< رنگ >

رنگ پر، در قالب هگزادسیمال RRGBBB . برای شفافیت ها، شش رقم اول نادیده گرفته می شود، اما به هر حال باید گنجانده شود.

مثال ها

شرح	مثال
این مثال پس زمینه نمودار را با خاکستری کم رنگ پر می کند ( 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 = آبی شفاف

بازگشت به بالا