Release History

4.5 - November 5, 2024

Added support for background maps via backgroundmap_js_url and backgroundmap_tiles_url.
Changed label_display 'auto' to not show when zoomed out and support ranges of values (e.g. ".9:.25").

4.4 - September 17, 2024

Removed dynamic inline styles to avoid CSP problems.
Updated all country maps to use current admin areas.
Added the main_settings property of height.
Added support to use GeoJSON to replace locations and state paths.
Added level to allow the z-index of all map features to be adjusted.

4.3 - March 22, 2024

Fixed bug that prevented links from being followed via keyboard navigation.
Updated all country maps to use current admin areas.
Fixed bug where iOS would double open links in some circumstances.
Changed mobile detection based no changes in how newer iPads identify themselves.
Updated refresh method to update the legend upon refresh.
Improved positioning of tooltip on mobile devices to make it less "jumpy".

4.2 - July 10, 2022

Added legend_position to the main_settings to allow the legend to be inside or outside the map.
Added sm_state sm_location sm_label sm_line classes so that the map can be more easily manipulated with CSS and JavaScript.
Added resize method to allow the map to be programmatically resized without needing to reload the map.
Added zoom_ratio property to the map.
Made accessible dropdowns alphabetized.
Fixed lat/lng calibration bug

4.1 - April 06, 2021

Added scroll to zoom.
Added built-in legend functionality.
Added state_pulse option to API.
Added display: 'auto' for labels.
Added built-in dropdown to make map accessible by keyboard.
Updated code minimization and removed all use of eval.

4.0 - April 13, 2020

Added official support for lines.
Added angle support for lines.
Allowed lines to be created from origin_location and destination_location.
Allowed regions to be hidden.
Allowed names to be hidden.
Fixed location refresh bug in on_click mode.
Fixed bug where states can stay stuck in hover mode.
Added lat/lng support to Puerto Rico.

3.9 - January 28, 2019

Embedded zooming library (shifty.js) within the map logic to reduce global dependencies.
Fixed bug with hooks when using multiple instances of a map.
Added label_opacity and label_hover_opacity to enable labels that appear on hover.
Added image_hover_url to locations so that location images can change on hover.
Changed default projection settings so that when no projection is set lng will be interpreted as x (on the SVG canvas) and lat will be interpreted as y.
Fixed bug with the way the map handles labels and locations that have a display property.
Made lines resize as the map scales.
Fixed bug with animated images when hovering out of a state.

3.81 - May 25, 2018

Modernized navigation buttons.
Added JavaScript hook ready. Equivalent to jQuery's $( document ).ready.
Added background_image_bbox to position background images.
Added support for lines (beta feature).
Added position: 'bottom' option to locations. Allows locations to be placed under states.
Added image_position option to locations. Allows locations images to be placed at 'center' or 'bottom-center'. Useful for custom marker images.

3.8 - March 1, 2018

Added support for background_image_url.
Added support for main_settings.location_image_position and location.image_position. Allows you to set the anchor point for location images. ['center', 'bottom-center']
Fixed bug related to manual zooming on mobile devices.

3.7 - December 4, 2017

Mobile devices now zoom smoothly (instead of snapping to last frame) by default. Controllable via main_settings.zoom_mobile.
Locations now stop scaling at a zoom ratio of .125 by default. This allows mobile users to be able to eventually increase the size of locations so that they can more easily click on them. Controllable via main_settings.scale_limit.
Pinch to zoom is now supported on mobile devices when manual zooming has been enabled.
diamond is now a location shape option.
You can now specify custom location shapes with a main_settings.custom_shapes dictionary. It should contain the SVG paths of shapes within a 1mm square box. e.g. {diamond: "M 0,-0.5 -0.4,0 0,0.5 0.4,0 Z"}
Fixed bug with background images and pill.
Fixed bug with state pills inheriting region attributes.
Made state background images fill the entire space when in center mode.

3.6 - August 18, 2017

Added marker, star, triangle, and heart location marker options.
Added support for state images via image_url and image_hover_url.
Added pulse option to location markers.
Adjusted main_settings.rotate to allow for label rotation.
Made adjacent_color work intuitively with main_settings.manual_zoom: 'yes','.
Moved labels to mapdata object by default to facilitate future editing via the online customization tool.
Added zoom_level, zoom_level_id, and proj(lat, lng) to the JavaScript API.
Added click_xy to the JavaScript hooks.
Made the scalability of labels and locations controllable via scale property.
Updated Congress map to reflect 115th redistricting.
Updated location and label display property to support zoom ratios (0-1).
Revamped label line to work with states and across all zoom levels.

3.5 - March 21, 2017

Allowed urls to automatically break out of iframes on sites like Wix by default.
Added support for url commands like url:"javascript:alert('example')" even if main_settings.url_new_tab='yes'.
Fixed a bug in how popups orient themselves.
Added main_settings.popup_orientation so that popup orientation can be manually controlled.
Made popups automatically centered in on_click mode when the map is less than 400px wide. This improves the user experience on mobile devices.
Added main_settings.popup_centered so that this option can be manually controlled.
Improved support for map instances with map.create() and map.copy().
Allowed new map instances to auto_load themselves when the document finishes loading.
Added map.mapinfo to the API so that state paths can be dynamically controlled.
Allowed individual states to overwrite main_settings.border_color which is helpful when visualizing small islands.
Added map.plugin_hooks to API, so that plugins can be written for the map without monopolizing public hooks.

3.4 - September 29, 2016

Added support for manual zooming and panning with main_settings.manual_zoom: 'yes',
Improved main_setitngs.auto_load: 'yes', load times by loading after the document instead of the window.
Added support for touch interaction on touch-capable, non-mobile devices (like touch laptops).
Updated the North America map to improve accuracy and load time.
Updated the Congress map to reflect redistricting.
Updated on_click tooltip with a cleaner look that is more mobile friendly.
Updated tooltip to use classes instead of ids to better support multiple maps on a page.
Fixed bug where inline tooltip styles were being duplicated when the map was reloaded.

3.3 - May 27, 2016

Recreated the US map for improved lon/lat accuracy and smaller file size
Added the US territory of American Samoa to the US map
Added Bahrain to the World map
Added support for border_hover_color and border_hover_size
You can now turn off main_settings.state_hover_color with 'off' (great for heat maps)
Fixed minor responsiveness bug
The initial view via is now editable via mapinfo.initial_view {x: value, y: value, x2: value: y2: value}
Changed to a more lightweight Tweening library for zooming
Incorporated lat/lng projection into the mapinfo object which gives the end user more control over the projection settings
Across all maps, any defined pixel sizes are now always relative to a 1000px SVG map
Optional region properties to overwrite bounding box were changed from x1,y1,x2,y2 to x, y, x2, y2 for consistency
Fixed minor back_arrow bug
Added refresh_state(id) to API to allow for more efficient refreshing
Added main_settings.location_image_url to easily add location images without needing to store them in a particular folder

3.2 - November 11, 2015

Updated main_settings.width: 'responsive', to play well with CSS transitions
Fixed conflict bug between main_settings.url_new_tab: 'yes', and main_settings.popups: 'on_click'
Changed default for main_settings.location_popups to be main_settings.popups

3.1 - April 23, 2015

Upgraded world map resolution and added many small islands
main_settings.location_popups, main_settings.state_popups, popup (state/region/location) give finer control over popups
Fixed tooltip error caused by scrolling on a page with a fixed header
Fixed bug where background color wasn't being changed on intial_zoom
Fixed minor css tooltip bug when in on_click mode and zoomed in to a region
Fixed console.log bug throwing errors in older browsers
Changed default regions in congress and county maps to use state abbreviations as ids
Enabled multiple instances of the same map via create_simplemaps_worldmap
Enabled these maps to be controlled independently via the storage of mapdata at simplemaps_worldmap.mapdata
simplemaps_worldmap.zoom_level() is now simplemaps_worldmap.zoom_level (string as opposed to function)
x1,y1,x2,y2 added as optional region properties to overwrite bounding box

3.0 - December 3, 2014

Responsive maps now resize themselves when the browser is resized or the page orientation changes
Made changes to the API Syntax
Made changes to the JavaScript hooks syntax so that js_hooks is no longer needed
Added JavaScript hooks to differentiate between terminal clicks and zooming clicks
Reworked regions so that continent object is no longer needed
Region zoom level can now be adjusted via zoom_percentage
Region color, hover_color, opacity, and hover_opacity have been added
Region properties can be passed on to member states via the cascade property
Zooming out can now be incremental with zoom_out_incrementally
Non-zoomable regions can now be created via the property zoomable
Location labels have now been deprecated
Added the following properties to locations: hover_color,border,hover_border, hover_opacity
Labels are now independent entities that can be fully customizable
Labels and locations can now be restricted to only appear when zoomed in to the region or state level (see the display property)
Label pills are now generated, and can be hidden, dynamically
In the US map, eastern labels and pills can now be hidden with hide_eastern_labels
Back arrow can now be a custom image
Back arrow can now be shown on map load and trigger external JavaScript (this makes it easy to connect maps)
Timing of zoom is now adjustable via zoom_time
Timing of hovered colors to return to their default color after mouse out is adjustable via fade_time
Link text for mobile users is now customizable
images_directory is now customizable
It is now possible to trigger pop_ups via the api
Maps with a width of responsive are now responsive to browser resizing and mobile orientation changes

2.9 - February 26, 2014

Added simplemaps_mapname_variables.current_region and simplemaps_mapname_variables.mobile as globally accessible variables
Fixed label bug affecting mobile devices
Added simplemaps_mapname_popup to JavaScript API, making it possible to programmatically open popups

2.8 - February 20, 2014

Changed <b> to <strong> in tooltip
Fixed JavaScript hook bug

2.7 - February 3, 2014

Fixed location image bug
Made zooming less computationally intense for IE7 & IE8
Added simplemaps_mapname_region_click JavaScript hook
Fixed iOS back arrow bug

2.6 - November 21, 2013

Added ability to customize label size
Fixed rare bug when in pop_ups: 'on_click', mode
Added location images
Added zooming_complete, complete and refresh_complete JavaScript hooks
Changed cursor for locations to pointer
Adding testing mode to map for troubleshooting and customization
Fixed pop_ups: 'off', bug
Fixed label bug when refreshing the map
Fixed IE7 & IE8 state zooming bug

2.4 - November 15, 2013

Fixed iOS double click bug
Added responsive setting to map

2.3 - May 12, 2013

Added label locations
Changed scaling method to improve IE support
Made back arrow customizable
Fixed background bug when zooming outside of the initial view
Changed popup styling to use modern CSS instead of images
Made popup CSS customizable via main_settings
Add pop_up: 'off', option
Added ability to zoom into states (not just regions)
Added initial JavaScript hooks
Encoded x.png image within the map source
Changed look of demo text
Fixed tooltip bug when reloading map
Improved positioning of tooltip
Changed location of tooltip relative to cursor to make better use of space
Changed some CSS class names for consistency
Added label color
Fixed location bug when refreshing map

2.0 - March 14, 2013

Changed z-index on tooltip
Added color and hover_color for regions
Improved transition from one tooltip to another when in on_click mode
Fixed label bug
Add url to regions
Added intial_zoom and initial_zoom_solo to regions
Added ability to refresh map (instead of reloading it)
Added location opacity
Separated out libraries from source

1.4 - February 25, 2013

Changed mobile detection in response to touch Windows
Added circle locations
Added logo to demos
Added ability to hide labels
Allowed map to be loaded manually

1.3 - February 5, 2013

Added ability to hide states
Added territories to US map

1.2 - December 4, 2012

Changed mobile detection
Improved back arrow
Added continent object to speed up zooming
Improved scalability
Made map automatically find the map_images folder
Made tooltip customizable via CSS

1.1 - November 27, 2012

Original public launch under Simplemaps.com domain