搜尋套件、儲存庫與 APP 分類

countries_world_map 封面
套件詳情v1.3.0

countries_world_map

一個簡單的可自訂世界地圖(或任何選擇的國家)小部件。可根據 ISO 兩位字母國家代碼(或州 ID)進行著色。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
5570
喜歡數
85
Pub 分數
150

安裝套件

flutter pub add countries_world_map

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

一個可自訂的 Flutter 小部件,用於顯示世界地圖,國家可根據 ISO 兩位字母國家代碼或狀態 ID 個別上色。非常適合視覺化全球統計資料、使用者位置或區域趨勢。地圖輕量且支援多個平台,包括 Android、iOS、Web、macOS、Windows 和 Linux。開發者可輕鬆使用動態色彩方案強調特定區域。

適用情境

  • 按國家可視化全球資料
  • 在地圖上突出顯示用戶位置
  • 顯示區域統計數據
  • 建立互動式國家選擇介面
  • 按區域自定地圖顏色

主要特色

  • 按 ISO 國家代碼進行顏色自定義
  • 對多個平台的支援
  • 輕量且易於整合
  • 基於狀態ID的動態著色
  • 用於特定國家樣式的簡單 API

適合對象

  • 數據可視化應用
  • 旅行和基於位置的服務
  • 全球分析儀表板
  • 帶地圖的教育工具
  • 互動式網頁和行動應用

使用建議

  • 需要有效的ISO國家代碼進行著色
  • 限於預定義的國家邊界
  • 性能可能因高解析度地圖而有所不同
  • 不適合用於詳細的地理分析
  • 地圖資料更新依賴於套件維護

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

countries_world_map

This package provides an easy to implement World Map (or any other country of choice) which is fully customizable. In this case "customizable" means the ability to change the color of a country/state/prefecture/province. Additionally when a country is touched the map provides a callback.

Example

Online example is available at countriesworldmap.simplewidgets.dev

Support

To see which countries are supported, please see the online example or the list below.

About this package

This flutter package draws a map of choice using the CustomPainter. These maps can be quite big so please read "Perfomance" below. When tapping a area on the map (country, state etc.) you will get a callback providing you with the name, id and tapdetails of the area being tapped.

How to use the widget

The main widget is the SimpleMap() widget which requires at least the instructions on how to draw the map. For all supported countries there are 2 classes SMap...() & SMap...Colors(). The first class only contains a static String which has the instructions for the SimpleMap widget. The second class has color properties that match with the ID's given to the area's in the instructions.

For example:

  • Spain has the following classes: SMapSpain() & SMapSpainColors().
  • Mexico has the following classes: SmapMexico() & SMapMexicoColors().
  • The World Map has the following classes: SMapWorld() & SMapWorldColors().
SimpleMap(
    // String of instructions to draw the map.
    instructions: SMapWorld.instructions, 


    // Default color for all countries.
    defaultColor: Colors.grey,       


    // Matching class to specify custom colors for each area.
    colors: SMapWorldColors( 
        uS: Colors.green,   // This makes USA green
        cN: Colors.green,   // This makes China green
        ru: Colors.green,   // This makes Russia green
     ).toMap(), 


    // Details of what area is being touched, giving you the ID, name and tapdetails
    callback: (id, name, tapdetails) {      
        print(id); 
    },
);

❗️ Please note: ID structure might be different between countries. The Color class and the instructions should always match, but there might be differences between different countries. When adding a map check how the ID is returned. Or open the online example to see the ID's in the right list.

Use cases

This packages can be used to visualize data by adding different shades of colors. When pressing a region you might want to show a bottomsheet containing more details.

Although it it possible to add multiple maps to your app, please read more about the performance before proceeding.

Tips for UI

  1. Wrap the WorldMap in an InteractiveViewer widget.

    Using InteractiveView enables you to zoom in and out on specific countries as done in the online example. In the example the InteractiveViewer has a maxScale of 75.

  2. Set the WorldMap to 92% of the available width to make it look more centered.

Performance

Some of the maps are really big, so (re)building the widget can be expensive. That's why the default Widget uses a RepaintBoundry to prevent it from unnecessary repaints. If you change a Country Color and call SetState() the widget will repaint.

In version 0.0.7 and before the size of the map would cause jank and compile errors. In the newer versions this should be fixed. However, if you plan on showing a lot of maps in your app. Please be advised and consider using Google Maps or Apple Maps instead, this because each map added to the app will increase the size of the final build.

Like to contribute?

Feel free to help us improve this package by creating issues, pull request etc. For any questions you can email hello@simplewidgets.dev

Countries with Maps

COUNTRY ISO SUPPORTED
Afghanistan AF
Albania AL
Algeria DZ
American Samoa AS
Andorra AD ✅
Angola AO ✅
Anguilla AI
Antarctica AQ
Antigua and Barbuda AG
Argentina AR ✅
Armenia AM ✅
Aruba AW
Australia AU ✅
Austria AT ✅
Azerbaijan AZ ✅
Bahamas (the) BS ✅
Bahrain BH ✅
Bangladesh BD ✅
Barbados BB
Belarus BY ✅
Belgium BE ✅
Belize BZ
Benin BJ
Bermuda BM
Bhutan BT ✅
Bolivia (Plurinational State of) BO ✅
Bonaire, Sint Eustatius and Saba BQ
Bosnia and Herzegovina BA ✅
Botswana BW ✅
Bouvet Island BV
Brazil BR ✅
British Indian Ocean Territory (the) IO
Brunei Darussalam BN ✅
Bulgaria BG ✅
Burkina Faso BF ✅
Burundi BI ✅
Cabo Verde CV ✅
Cambodia KH
Cameroon CM ✅
Canada CA ✅
Cayman Islands (the) KY
Central African Republic (the) CF ✅
Chad TD ✅
Chile CL ✅
China CN ✅
Christmas Island CX
Cocos (Keeling) Islands (the) CC
Colombia CO ✅
Comoros (the) KM
Congo (the Democratic Republic of the) CD ✅
Congo (the) CG ✅
Cook Islands (the) CK
Costa Rica CR ✅
Croatia HR ✅
Cuba CU ✅
Curaçao CW
Cyprus CY ✅
Czechia CZ ✅
Côte d'Ivoire CI ✅
Denmark DK ✅
Djibouti DJ ✅
Dominica DM
Dominican Republic (the) DO ✅
Ecuador EC ✅
Egypt EG ✅
El Salvador SV ✅
Equatorial Guinea GQ
Eritrea ER
Estonia EE ✅
Eswatini SZ
Ethiopia ET ✅
Falkland Islands (the) [Malvinas] FK
Faroe Islands (the) FO ✅
Fiji FJ
Finland FI ✅
France FR ✅
French Guiana GF
French Polynesia PF
French Southern Territories (the) TF
Gabon GA
Gambia (the) GM
Georgia GE ✅
Germany DE ✅
Ghana GH
Gibraltar GI
Greece GR ✅
Greenland GL
Grenada GD
Guadeloupe GP
Guam GU
Guatemala GT ✅
Guernsey GG
Guinea GN ✅
Guinea-Bissau GW
Guyana GY
Haiti HT ✅
Heard Island and McDonald Islands HM
Holy See (the) VA
Honduras HN ✅
Hong Kong HK ✅
Hungary HU ✅
Iceland IS
India IN ✅
Indonesia ID ✅
Iran (Islamic Republic of) IR ✅
Iraq IQ ✅
Ireland IE ✅
Isle of Man IM
Israel IL ✅
Italy IT ✅
Jamaica JM ✅
Japan JP ✅
Jersey JE
Jordan JO
Kazakhstan KZ ✅
Kenya KE ✅
Kiribati KI
Korea (the Democratic People's Republic of) KP
Korea (the Republic of) KR ✅
Kosovo XK ✅
Kuwait KW
Kyrgyzstan KG ✅
Lao People's Democratic Republic (the) LA ✅
Latvia LV ✅
Lebanon LB
Lesotho LS
Liberia LR
Libya LY
Liechtenstein LI ✅
Lithuania LT ✅
Luxembourg LU ✅
Macao MO
Madagascar MG
Malawi MW
Malaysia MY ✅
Maldives MV
Mali ML ✅
Malta MT ✅
Marshall Islands (the) MH
Martinique MQ
Mauritania MR
Mauritius MU
Mayotte YT
Mexico MX ✅
Micronesia (Federated States of) FM
Moldova (the Republic of) MD ✅
Monaco MC
Mongolia MN
Montenegro ME ✅
Montserrat MS
Morocco MA ✅
Mozambique MZ ✅
Myanmar MM ✅
Namibia NA ✅
Nauru NR
Nepal NP ✅
Netherlands (the) NL ✅
New Caledonia NC
New Zealand NZ ✅
Nicaragua NI ✅
Niger (the) NE
Nigeria NG ✅
Niue NU
Norfolk Island NF
Northern Mariana Islands (the) MP
Norway NO ✅
Oman OM ✅
Pakistan PK ✅
Palau PW
Palestine, State of PS ✅
Panama PA ✅
Papua New Guinea PG
Paraguay PY ✅
Peru PE ✅
Philippines (the) PH ✅
Pitcairn PN
Poland PL ✅
Portugal PT ✅
Puerto Rico PR ✅
Qatar QA ✅
Republic of North Macedonia MK ✅
Romania RO ✅
Russian Federation (the) RU ✅
Rwanda RW ✅
Réunion RE
Saint Barthélemy BL
Saint Helena, Ascension and Tristan da Cunha SH
Saint Kitts and Nevis KN
Saint Lucia LC
Saint Martin (French part) MF
Saint Pierre and Miquelon PM
Saint Vincent and the Grenadines VC
Samoa WS
San Marino SM ✅
Sao Tome and Principe ST
Saudi Arabia SA ✅
Senegal SN
Serbia RS ✅
Seychelles SC
Sierra Leone SL ✅
Singapore SG ✅
Sint Maarten (Dutch part) SX
Slovakia SK ✅
Slovenia SI ✅
Solomon Islands SB
Somalia SO
South Africa ZA ✅
South Georgia and the South Sandwich Islands GS
South Sudan SS
Spain ES ✅
Sri Lanka LK ✅
Sudan (the) SD ✅
Suriname SR
Svalbard and Jan Mayen SJ
Sweden SE ✅
Switzerland CH ✅
Syrian Arab Republic SY ✅
Taiwan (Province of China) TW ✅
Tajikistan TJ ✅
Tanzania, United Republic of TZ
Thailand TH ✅
Timor-Leste TL
Togo TG
Tokelau TK
Tonga TO
Trinidad and Tobago TT
Tunisia TN
Turkey TR ✅
Turkmenistan TM
Turks and Caicos Islands (the) TC
Tuvalu TV
Uganda UG ✅
Ukraine UA ✅
United Arab Emirates (the) AE ✅
United Kingdom of Great Britain and Northern Ireland (the) GB ✅
United States Minor Outlying Islands (the) UM
United States of America (the) US ✅
Uruguay UY ✅
Uzbekistan UZ ✅
Vanuatu VU
Venezuela (Bolivarian Republic of) VE ✅
Viet Nam VN ✅
Virgin Islands (British) VG
Virgin Islands (U.S.) VI
Wallis and Futuna WF
Western Sahara EH
Yemen YE ✅
Zambia ZM ✅
Zimbabwe ZW ✅
Åland Islands AX

所屬分類

依賴

依賴清單 1 項

  • quantity^3.0.0

原始碼儲存庫

使用此套件的專案