هشدار جایگزینی : این نمودار نقشه با نسخه جدیدتر جایگزین شده است.
در این صفحه نحوه ایجاد یک نقشه رنگی با استفاده از Charts 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
) آمده است.
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" است.
مثال ها
شرح | مثال |
---|---|
نموداری با عنوان، با استفاده از رنگ و اندازه فونت پیشفرض. یک فاصله با علامت مثبت ( از یک کاراکتر لوله ( | 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>
- < margin_left >، < right_margin >، < top_margin >، < bottom_margin >
- حداقل اندازه حاشیه در اطراف منطقه نمودار، بر حسب پیکسل. برای جلوگیری از برخورد برچسبهای محور با مرزهای نمودار، این مقدار را افزایش دهید تا مقداری بالشتک اضافه شود.
- < opt_legend_width >، < opt_legend_height >
- [ اختیاری ] عرض حاشیه اطراف افسانه، بر حسب پیکسل. از این برای جلوگیری از برخورد افسانه در ناحیه نمودار یا لبه های تصویر استفاده کنید.
مثال ها
شرح | مثال |
---|---|
در این مثال، نمودار دارای حداقل حاشیه 30 پیکسل در هر طرف است. از آنجایی که پهنای افسانه نمودار بیش از 30 پیکسل است، حاشیه سمت راست به عرض نمودار نمودار تنظیم می شود و با حاشیه های دیگر متفاوت است. برچسب های محور خارج از منطقه طرح هستند و بنابراین در فضای حاشیه ترسیم می شوند. |
|
برای اضافه کردن حاشیه در اطراف افسانه، مقداری را برای پارامترهای در این مثال، پهنای افسانه تقریباً 60 پیکسل است. اگر |
|
پس زمینه chf
را پر می کند [ همه نمودارها ]
می توانید رنگ ها و سبک های پر را برای ناحیه داده نمودار و/یا کل پس زمینه نمودار مشخص کنید. انواع پر شامل پرهای جامد، پرهای راه راه و گرادیان است. می توانید پرهای متفاوتی را برای نواحی مختلف مشخص کنید (مثلاً کل ناحیه نمودار یا فقط ناحیه داده). پر کردن ناحیه نمودار، پر کردن پسزمینه را بازنویسی میکند. همه پرها با استفاده از پارامتر chf
مشخص میشوند و میتوانید انواع مختلف پر (جامد، راه راه، گرادیان) را با جدا کردن مقادیر با کاراکتر لوله ( | ) در یک نمودار ترکیب کنید. ناحیه نمودار پر می شود پرهای پس زمینه نمودار را بازنویسی می کند.
Solid Fills chf
[ همه نمودارها ]
میتوانید برای پسزمینه و/یا ناحیه نمودار یک پرکننده جامد مشخص کنید، یا یک مقدار شفافیت به کل نمودار اختصاص دهید. با استفاده از کاراکتر pipe ( |
) می توانید چندین پر را مشخص کنید. (نقشه ها: فقط پس زمینه).
نحو
chf=<fill_type>,s,<color>|...
- < fill_type >
- بخشی از نمودار در حال پر شدن یکی از مقادیر زیر را مشخص کنید:
-
bg
- پر کردن پس زمینه -
c
- پر کردن منطقه نمودار. برای نمودارهای نقشه پشتیبانی نمی شود. -
a
- کل نمودار (از جمله پس زمینه) را شفاف کنید. شش رقم اول< color >
نادیده گرفته می شود و تنها دو رقم آخر (مقدار شفافیت) به کل نمودار و همه پرها اعمال می شود. -
b <index>
- پرهای جامد میله ای (فقط نمودارهای میله ای). برای پر شدن با یک رنگ ثابت، < index > را با شاخص سری میله ها جایگزین کنید. این اثر شبیه به تعیینchco
در نمودار میله ای است. برای مثال رنگ های سری نمودار میله ای را ببینید.
-
- س
- پر شدن جامد یا شفاف را نشان می دهد.
- < رنگ >
- رنگ پر، در قالب هگزادسیمال RRGBBB . برای شفافیت ها، شش رقم اول نادیده گرفته می شود، اما به هر حال باید گنجانده شود.
مثال ها
شرح | مثال |
---|---|
این مثال پس زمینه نمودار را با خاکستری کم رنگ پر می کند ( | |
این مثال پسزمینه نمودار را با خاکستری کم رنگ پر میکند ( | |
این مثال شفافیت 50٪ را برای کل نمودار اعمال می کند (80 در هگزادسیمال 128 است یا حدود 50٪ شفافیت). به پسزمینه سلول جدول که در نمودار نشان داده میشود، توجه کنید. | |
رنگ ها را با استفاده از یک رشته 6 کاراکتری از مقادیر هگزادسیمال، به اضافه دو مقدار شفافیت اختیاری، در قالب RRGGBB[ AA ]
مشخص کنید. مثلا:
-
FF0000
= قرمز -
00FF00
= سبز -
0000FF
= آبی -
000000
= سیاه -
FFFFFF
= سفید
AA
یک مقدار شفافیت اختیاری است که در آن 00
کاملاً شفاف و FF
کاملاً مات است. مثلا:
-
0000FFFF
= آبی یکدست -
0000FF66
= آبی شفاف