dsamourkasidis

Map Visualizer allows users to import csv files, and to create a map out of them using the plugin’s interface. 
After you have successfully imported (or created) a data source, you can visualise it on a map and add it to your posts/pages with a shortcode. 
All shortcodes can be constructed easily through the plugin’s interface.
<h4>CSV File Format</h4>
In order for the CSV file to be imported successfully, its format must comply with the following rules:
<ul>
<li>
The first row must contain all the Header names:
<ul>
<li>If you use geographical coordinates, the headers of the first two column must be named “Latitude” and “Longitude” respectively. </li>
<li>If you use addresses, the first column must be named “Address” and the plugin will geocode the data accordingly.</li>
<li>If you wish to use polygons, the first column must be named “Polygon”. Format of polygon data should be of Well-Known Text.</li>
</ul>
</li>
<li>
The second row must contain the data type of each column:
<ul>
<li>Available data types include “INT”, “FLOAT” and “TEXT”.</li>
<li>For “Latitude” and “Longitude” headers, the data type to be used is “FLOAT”.</li>
<li>For “Polygon” or “Address” headers, the data type to be used is “TEXT”.</li>
</ul>
</li>
</ul>
<h4>shortcode format</h4>
The general format of this plugin’s shortcodes is [visualise]. Available attributes include:
<ul>
<li>“file_name” : The name of the file imported you wish to visualise.</li>
<li>“map” : The map type to be used for the visualization. You can choose between “Satellite” or “Streets” maps and the default one is “Streets”.</li>
<li>“type” : Type of visualization. Either visualise your data as “polygon” or as “marker”. Default type is “marker”.</li>
<li>“marker_type” : Choose between “simple marker” or “circle_marker” to be pinned on the chosen map. The default markers are “simple marker”.</li>
<li>“category” : Header Name of your file, which will be used to differentiate the data based on the marker_type chosen.</li>
<li>“colorant” : Color of circle_markers and polygons, used to differentiate the data.</li>
<li>“circle_radius” : Radius of circle_markers. The default value is 5, and it is advised to stay between a 1-10 scale.</li>
<li>“fill_opacity” : Level of opacity for circle_markers and polygons. The default value is 0.3, and it is advised to stay between a 0.1-1 scale.</li>
<li>“center_point” : An Address for setting the initial center point of the map.</li>
<li>“zoom” : Initial zoom of the map. Value 1 shows the entire world map and the default zoom used is 3.</li>
</ul>

Map Visualizer

Import your data from csv files and visualise them on Google streets/satellite maps

Ian Dunn

BGMP creates a <a href="http://www.youtube.com/watch?v=FWkLBPpGOmo#!" rel="nofollow ugc">custom post type</a> for placemarks (markers) on a Google Map. The map is embedded into pages or posts using a shortcode, and there are settings to affect how it’s displayed. You can create markers that will show up on the map, and set their icons using the Featured Image meta box. When a marker is clicked on, a box will appear and show the marker’s title and description.
Features
<ul>
<li>Each map marker can have a unique custom Installation icon, share a common custom icon, or use the default icon.</li>
<li>Options to set the map type (street, satellite, etc), center location, size, zoom level, navigation controls, etc.</li>
<li>Setup unique maps on different pages with their own placemarks, map types, center locations, etc.</li>
<li>Placemarks can be assigned to categories, and you can control which categories are displayed on a individual map.</li>
<li>Marker clustering for large numbers of placemarks</li>
<li>Extra shortcode to output a text-based list of markers for mobile devices, search engines, etc.</li>
<li>Lots of filters so that developers can customize and extend the plugin.</li>
<li>Use HTML, images, etc inside the information window.</li>
<li>Compatible with WordPress MultiSite.</li>
<li>Internationalized (see <a href="https://wordpress.org/extend/plugins/basic-google-maps-placemarks/other_notes/" rel="ugc">Other Notes</a> for a list of supported languages)</li>
</ul>
Live Examples
<ul>
<li><a href="http://www.polioaustralia.org.au/?page_id=6098" rel="nofollow ugc">The Australian Polio Register</a></li>
<li><a href="http://fdmaps.com/forestry-ncfs-and-usfs-combined/" rel="nofollow ugc">The North Carolina Fire Station Mapping Project</a></li>
<li><a href="http://washingtonhousechurches.net" rel="nofollow ugc">Washington House Churches</a></li>
</ul>
Support
I’m happy to fix reproducible bugs, but don’t have time to help you customize the plugin to fit your needs. There’s also plenty of documentation and community support available. Check out the ‘How can I get help when I’m having a problem?’ question in <a href="https://wordpress.org/extend/plugins/basic-google-maps-placemarks/faq/" rel="ugc">the FAQ</a> for details. 
Localizations
<ul>
<li>Spanish (thanks to Andrew Kurtis from <a href="http://www.webhostinghub.com/" rel="nofollow ugc">WebHostingHub</a>)</li>
<li>Chinese (thanks to <a href="https://wordpress.org/support/profile/yzqiang" rel="ugc">yzqiang</a>)</li>
<li>Russian (thanks to <a href="https://profiles.wordpress.org/alexgr" rel="nofollow ugc">alexgr</a>)</li>
<li>French (thanks to Romain Fevre)</li>
<li>German (thanks to Jens)</li>
<li>Italian (thanks to <a href="http://www.acolombodesign.com/" rel="nofollow ugc">Andrea Colombo</a>)</li>
<li>Serbo-Croatian (thanks to Borisa Djuraskovic from <a href="http://www.webhostinghub.com/" rel="nofollow ugc">WebHostingHub</a>)</li>
<li>Dutch (thanks to <a href="https://profiles.wordpress.org/mardonios/" rel="nofollow ugc">mardonios</a>)</li>
</ul>
If there isn’t a translation for your language (or it is incomplete/inaccurate) please consider making one and contributing it to the plugin. You can learn how by reading <a href="https://codex.wordpress.org/Translating_WordPress" rel="nofollow ugc">Translating WordPress</a> and <a href="http://www.wdmac.com/how-to-create-a-po-language-translation" rel="nofollow ugc">How to Create a .po Language Translation</a>. The .pot file you’ll need is inside the languages directory in the plugin’s folder. Once you’re done, just start a thread on <a href="https://wordpress.org/support/plugin/basic-google-maps-placemarks" rel="ugc">the support forum</a> with links to the .po and .mo files, and I’ll add them to the next release. You can also subscribe to <a href="http://iandunn.us6.list-manage1.com/subscribe?u=38510a08f1d822cc1c358e644&id=b7ff5f7393" rel="nofollow ugc">the BGMP Translators e-mail list</a> to be notified when updated versions have new strings to translate.
Known conflicts
<ul>
<li>The <a href="https://wordpress.org/extend/plugins/post-types-order/" rel="ugc">Post Types Order</a> plugin can cause <a href="https://wordpress.org/support/topic/plugin-basic-google-maps-placemarks-shortcode-bgmp-list-not-returning-all-placemarks" rel="ugc">the wrong placemarks to show up</a> in [bgmp-map] or [bgmp-list] results. Try disabling the AutoSort feature.</li>
<li>The <a href="https://wordpress.org/extend/plugins/better-wp-security/" rel="ugc">Better WP Security</a> plugin may <a href="https://wordpress.org/support/topic/plugin-better-wp-security-google-maps-api" rel="ugc">break the Google Maps API</a> if the “Display random version number” option is enabled.</li>
<li>The [bgmp-map] and [bgmp-list] shortcodes <a href="https://wordpress.org/support/topic/plugin-basic-google-maps-placemarks-map-showing-all-placemarkers-no-filter" rel="ugc">won’t work in WP e-Commerce product post types</a>.</li>
<li>Also make sure that no other Google Maps plugins are activated, and that your theme isn’t including the Maps API. You can view the page’s source code and search for instances of “maps.google.com/maps/api/js”. If there’s more than one, then you’re probably going to have issues.</li>
</ul>
How you can help with the plugin’s development
<ul>
<li>The thing I could really use some help with is answering questions on <a href="https://wordpress.org/support/plugin/basic-google-maps-placemarks" rel="ugc">the support forum</a>. I don’t have a lot of time to work on the plugin, so the time I spend answering questions reduces the amount of time I have to add new features. If you’re familiar with the plugin and would like to help out, you can click the ‘Subscribe to Emails for this Plugin’ link to get an e-mail whenever a new post is created.</li>
<li>Translate the plugin into your language. See the Localizations section above for details.</li>
<li>Volunteer to test new versions before they’re officially released. Sign up for <a href="http://iandunn.us6.list-manage.com/subscribe?u=38510a08f1d822cc1c358e644&id=b183d686c6" rel="nofollow ugc">the BGMP Testers e-mail list</a> to be notified when new release candidates are available for testing.</li>
<li>If you find a bug, create a post on <a href="https://wordpress.org/support/plugin/basic-google-maps-placemarks" rel="ugc">the support forum</a> with as much information as possible. If you’re a developer, create a patch and include a link to it in the post.</li>
<li>Send me feedback on how easy or difficult the plugin is to use, and where you think things could be improved. Add a post to <a href="https://wordpress.org/support/plugin/basic-google-maps-placemarks" rel="ugc">the support forum</a> with details.</li>
<li>Send me feedback on ways the documentation could be more clear or complete. Add a post to <a href="https://wordpress.org/support/plugin/basic-google-maps-placemarks" rel="ugc">the support forum</a> with details.</li>
<li>Review the code for security vulnerabilities and best practices. If you find a security issue, please <a href="http://iandunn.name/contact" rel="nofollow ugc">contact me</a> privately so that I can release a fix for it before publicly disclosing it.</li>
<li>Check the TODO.txt file for features that need to be added and submit a patch.</li>
</ul>
Donations
I do this as a way to give back to the WordPress community, so I don’t want to take any donations. If you’d like to give something, though, I’d encourage you to make a donation to <a href="http://www.doctorswithoutborders.org" rel="nofollow ugc">Doctors Without Borders</a> or the <a href="http://wordpressfoundation.org" rel="nofollow ugc">WordPress Foundation</a>.
Customization
If you need to customize BGMP and a solution isn’t already available in the forums, the best thing to do is to hire a developer. <a href="https://www.meetup.com/topics/wordpress/" rel="nofollow ugc">Your local WordPress Meetup</a> is a great place to meet one, or you can also check out <a href="http://jobs.wordpress.net" rel="nofollow ugc">jobs.wordpress.net</a>.
If you make customizations that could be beneficial to other users, please start a thread on <a href="https://wordpress.org/support/plugin/basic-google-maps-placemarks" rel="ugc">the support forum</a> with a description of them and a link to the source code.

Basic Google Maps Placemarks

Embeds a Google Map into your site and lets you add map markers with custom icons and information windows.

Map Visualizer vs Basic Google Maps Placemarks