Note: Depending on the map, state could refer to a state, province or country.
|Properties (these overwrite the properties in the main settings)|
|name||Primarily for identification purposes. However, you can overwrite a state's name.|
|description||This will fill up the popup and can include HTML/CSS. If it exists, it will overwrite main_settings.state_description.|
|color||The state's color. If it exists, it will overwrite main_settings.state_color.|
|hover_color||The state's hover_color. If it exists, it will overwrite main_settings.state_hover_color.|
|url||The url when the state is clicked. (e.g. 'http://simplemaps.com'). If it exists, it will overwrite main_settings.state_url.|
|hide||'yes' makes the state invisible.|
|zoomable||'yes' will zoom into the state upon click instead of redirecting to the url. If it exists, it will overwrite main_settings.all_states_zoomable|
|zoom_percentage||The percentage of the canvas that a zoomed state should take up. (e.g. '.9', would create a 10% border around the zoomed state).|
|inactive||'yes' will make hovering or clicking on a state have no effect. If it exists, it will overwrite main_settings.all_states_inactive|
|popup||Override main_settings.popups for this state.|
|border_color||The state's border color. Note, state borders overlap, so you should use the same color for states that border each other. This is best used for small islands.|
|Background Image (use a background image instead of color or hover_color, no IE7/IE8 support)|
|image_url||The url of the background image [e.g. 'https://simplemaps.com/static/img/frog.png'].|
|image_size||The size of the image. If:
0 > image_size < 1 ... it will be treated as a fraction of the state's bounding box.
image_size > 1 ... it will be treated as the width, in pixels, of the image.
image_size is 'auto' ... it will chosen automatically based on image_position.
|image_position||By default, 'center', places the image in the center and will always fill the state. 'manual' allows you to set placement via image_x and image_y. 'repeat' will repeat as image_size allows. ['center', 'repeat', 'manual']|
|image_x||If image_position: 'manual', adjust the horizontal placement of the image as as fraction of the state's bounding box width. [0-1]|
|image_y||If image_position: 'manual', adjust the vertical placement of the image as as fraction of the state's bounding box height. [0-1]|
|image_color||If the aspect ratio of the image does not match the aspect ratio of the state's bounding box (and the image isn't large enough), some of the state will remain uncovered. This overwrites the default background color of color. [e.g. '#ffffff']|
The above can also differ when the state is hovered over. In other words, the following analogous properties are also valid: image_hover_url, image_hover_size, image_hover_position, image_hover_x, image_hover_y, and image_hover_color.
These properties can be made defaults by adding them to the main_settings with the prefix 'state_'. [e.g. state_image_url, state_image_hover_url]
Note: pill's will not inherit state background images. They will use the state color and hover_color.