Title: Geo2 Maps Add-on for NextGEN Gallery Author: Pawel Published: Февраль 29, 2012 Last modified: Апрель 5, 2026 --- Search plugins ![](https://ps.w.org/nextgen-gallery-geo/assets/banner-772x250.jpg?rev=2484692) ![](https://ps.w.org/nextgen-gallery-geo/assets/icon-256x256.jpg?rev=2484692) # Geo2 Maps Add-on for NextGEN Gallery By [Pawel](https://profiles.wordpress.org/pablo2/) [Download](https://downloads.wordpress.org/plugin/nextgen-gallery-geo.2.1.6.zip) * [Details](https://os.wordpress.org/plugins/nextgen-gallery-geo/#description) * [Reviews](https://os.wordpress.org/plugins/nextgen-gallery-geo/#reviews) * [Installation](https://os.wordpress.org/plugins/nextgen-gallery-geo/#installation) * [Development](https://os.wordpress.org/plugins/nextgen-gallery-geo/#developers) [Support](https://wordpress.org/support/plugin/nextgen-gallery-geo/) ## Description !!! Please notice that “Ratings” do not represent the current plugin version quality– which was updated and corrected. Please check by yourself and leave feedback. NGG Geo2 Maps Add-on is a flexible extension plugin for free or Pro NextGEN Gallery( tested up to version 4.0.4), displaying maps with your photos, galleries or albums located using EXIF GPS data or geocoding. The goal of this plugin is to add to WordPress similar geolocation functionality as other web-based self-hosted photo manager apps have like Gallery 3, Piwigo, PhotoPrism or LibrePhotos. The plugin is using Microsoft Azure Maps and requires free Azure Maps API Key to function. #### Features * Maps with geo-located photos – Create maps with your photos, using their GPS data. * Support for JPEG and WebP images, with fast, native metadata reading. * Support for different representation of photos on a map: 7 Azure maps Pushpins, Thumbnails (round, rectangular) * Preview photos by clicking on a Pushpins/Thumbnails in an Infobox or one of 3 Lightboxes (Fancybox, Slimbox 2 or Fancybox 3) * Customise Lightboxes: colours and controls * Fancybox 3 Bottom Caption Panel with additional image EXIF and GPS info * Route mode with GPX, GML, KMZ, KML, GeoRSS, GeoJSON, spatial CSV support: displays your travel route together with photos or any other data * Worldmap mode: shows all or specific photos, galleries and albums on an overview map, open or preview galleries (via Ajax) * Include your maps by using Shortcodes * Include maps automatically in every post with a NextGEN gallery * Open maps on requests (via Ajax) * Create maps with specific photos only * Create multiple maps on one page * Enlarge maps to full screen * Mini Map module * Different visual styles for maps * Itemized options panel: configure many available options * Language support: users can create translations (English, Polish included) * Geolocation of galleries and albums in the Worldmap mode using Title ## Screenshots * [[ * Round pins with hover effect. Satellite map style and mini map. * [[ * The Infobox showing detailed information about a picture. Hybrid map style. * [[ * Rectangular thumbnails with border in portrait or landscape orientation. Terra map style. * [[ * World Map with square Thumbnails. No map Dashboard. * [[ * Worldmap with different pins for albums and galleries. No map Dashboard. * [[ * Closed map in Ajax Mode shows enable bar. * [[ * Opened map in Ajax Mode with round thumbnails. Satellite map style. Increased pitch. * [[ * Route Mode displaying .kmz path. Road map style. * [[ * Photo preview with Fancybox 3 Lightbox. * [[ * Photo preview with Slimbox 2 Lightbox. * [[ * Photo preview with Fancybox Lightbox. ## Installation 1. Install NextGEN Gallery – This plugin can only work with it. Create some galleries. 2. Install Geo2 Maps from plugins repository or download and extract the zip file into the wp-content/plugins/ directory of your WordPress installation. 3. Optional. If upgrading from version 2.0.X or lower check Restore default settings” of the Geo2 Maps plugin at the bottom of the General tab and deactivate and activate this plugin. 4. Acquire the Azure Maps API Key from Microsoft Azure page at https://azure.microsoft. com (You can find a links on the General tab inside this plugin.) 5. In the Azure account add your domain to CORS allowed origins. 6. Go to the admin panel ( NextGEN Gallery -> Geo2 Maps ) and paste the Key to the corresponding field on the Geocoding tab. 7. Configure any options as you require. #### Optional 1. Acquire free Mapquest API Key at https://developer.mapquest.com/ and input to the corresponding field on the Geocoding tab. 2. Input a valid email to use Nominatim on the same tab. Please read their Usage Policy at https://operations.osmfoundation.org/policies/nominatim. 3. Create a Shortcode and place it anywhere on your site. ## FAQ ### How can I acquire the API Key? Go to: https://azure.microsoft.com and click Get started with Azure” and then Try Azure for free”. You will need a Microsoft account. Log in to it. Follow the instructions to create a new Azure Maps account and Get the subscription key for your account in here: https://learn.microsoft.com/en-us/azure/azure-maps/quick-demo-map-app. Copy and past the key to the corresponding field on the General tab. Important: Add your website domain to the CORS Allowed Origins field i.e. https:// www.yourdomainname.com. This service is free up to a certain limit.Azure Maps offers a number of free transactions each month as shown in Azure Maps pricing (https://azure.microsoft.com/en-us/pricing/ details/azure-maps). For example, you get 5,000 free Base Map Tile transactions per month. Each transaction can include up to 15 tiles for a total of 75,000 tiles rendered for free each month. ### How can I use Geo2 Maps? There are three ways of using Geo2 Maps Add-on: _1. Generate maps automatically_ The plugin searches for galleries in your posts and includes a map if there is geodata available. Easy to use, you don’t need to change anything on your theme. _2. Include maps using the shortcode [geo2]_ Simply use the shortcode [geo2] anywhere in your posts. You can define plenty of options. _3. Use the php-function_ (for theme development) If you want to embed the plugin in your theme, you can use the following php-functions: – specify which galleries using $options[‘id’] – specify which pictures using $options[‘ pid’] – specify galleries or/and albums using $options[‘include’] = galleries”, albums” or all” If you don’t define any gallery ids, the plugin will search for the gallery ID in the post. If you don’t define any picture ids or tag names, the plugin will show an empty map. For Worldmap if you don’t define any gallery or album ids, the plugin will show all galleries and albums. $options must be defined as an array, containing the same data as the shortcodes. The parameters are optional. By delivering the IDs of the objects or tag names, this function can be used outside of The Loop. Example: $options = array( $options[‘map_width’] = ‘auto’, $options[‘map_height’] = ‘500px’ ); ### Shortcode? Which Shortcodes? There is only one Shortcode: [geo2] followed by options. All available Shortcode options are described in the Geo2 Maps options panel. ( NextGEN Gallery -> Geo2 Maps ) Example: [geo2 id=18 map=road map_height=100px map_width=200px exif=1 minimap=1][ geo2 worldmap=1 include=all map=road map_height=500px map_width=auto] [geo2 pid= 2,4,15 xmlurl=http://path_to_your_file_with_route.gpx] ### Can I use this plugin, even if there is no GPS data stored in the EXIF of my photos? Yes, to some extent. The plugin will try to place a gallery or an album on a map using geocoding even if no photos have GPS data. You can use different providers for geocoding, sometimes they generate differing results. Try to define a clear and unique Title corresponding to a location name. Unfortunately, the plugin will not show photos on a map if they have no GPS coordinates! But don’t worry. You can add them by using free Geosetter” for example. ### What is the Ajax Mode? If you don’t want maps to get loaded every time, you can use the Ajax mode. If activated, the plugin will display a button. Clicking on it will load this map using an Ajax request. ### What is the Worldmap Mode? The Worldmap mode gives you the possibility to show an overview of all or specific galleries and albums of your blog. If the preview picture has GPS coordinates gallery will be placed using it. Otherwise, the position will be geolocated using the title. You can include the Worldmap in your post by using the shortcode [geo2 worldmap= 1]. ### What is the Route Mode? You can use the Route mode, to display your travel route. Therefore, photos taken during this trip can be connected by it. The Route mode can be activated for all galleries using the options panel. Alternatively, you can activate the route mode for single maps using the shortcode. If you have recorded your route to a file, you can upload it to the gallery folder. Place a path to it in a map Shortcode. Example: [geo2 xmlurl=http://path_to_your_file_with_route.gpx] Accepted are common geospatial XML file formats such as KML (Keyhole Markup Language), KMZ (compressed KML), GeoRSS, GeoJSON, GML (Geography Markup Language, exposed via GeoRSS), GPX (GPS Exchange Format) and Spatial CSV. You can show any information contained in these files on a map. ### Why I can’t upload my route file to WordPress Media Library? For security reasons, WordPress is allowing to upload files only of a specific type. You can unlock uploading a specific file type by telling WordPress which MIME Type it should consider as safe. Some additional plugins can do this easily. I’m using Enhanced Media Library. These are the MIME Types you may want to register: gpx => ‘application/gpx+xml’ xml => ‘application/xml’ kml => ‘application/vnd.google-earth.kml+xml’ kmz => ‘application/ vnd.google-earth.kmz’ ### How can I define the map style? Some options like map-width and map-height can be changed in the options panel. The maps are using the div-class .geo2_maps_map, so you can use CSS, too. ### Can I reset all parameters to default values without uninstalling the plugin? You. There is an option to do so at the bottom of the General” tab. You will still need to deactivate and reactivate it after selecting this option. ### I made changes to my galleries but I do not see changes on maps. This is likely due to the caching of EXIF and GPS data which is used to speed up map loading. To see your changes immediately, go to the plugin settings (General tab) and check Disable EXIF Caching”. This will clear the cache. You can re-enable it afterwards to restore performance benefits. ## Reviews ![](https://secure.gravatar.com/avatar/3fc755492c3b9b61d2e3b5ea8a09036c81ad688000026b28e2e6c0d8898fb323? s=60&d=retro&r=g) ### 󠀁[Messes up the shopping cart](https://wordpress.org/support/topic/messes-up-the-shopping-cart/)󠁿 [atexanlife](https://profiles.wordpress.org/atexanlife/) Июль 9, 2022 1 reply Loved this plugin at first. All the way up until I tried to insure the ecommerce was still working. As soon as I would try to view cart, it would take me back to my prints for sale page. I deactivated the plugin and instantly I could view the cart and check out. Using Wordpress 6, Nextgen Pro 3.13.0, and Imagely themes 2.0. I hope they get it fixed. It was nice for others to see exactly where the photos they are buying were taken. ![](https://secure.gravatar.com/avatar/a9f2de0970db044b956bed74bb5f1927656f88c9ccb7a9b5cd5cfb5f64dda807? s=60&d=retro&r=g) ### 󠀁[Great tool to replace WP GPX maps!](https://wordpress.org/support/topic/great-tool-to-replace-wp-gpx-maps/)󠁿 [Arnoud](https://profiles.wordpress.org/derice/) Август 21, 2021 I have been using NextGen Gallery on my website for years. Including maps with routes and geo-tagged images. Was a happy user of WP GPX Maps, but that it no longer maintained it seems. Although this plugin was gathering dust for some time, it’s now being dusted off and for me can now replace WP GPX Maps on my website, so I can finally switch to PHP8! Would be cool if Google Maps is added in the future (with own API key ofcourse). ![](https://secure.gravatar.com/avatar/bb4b5d972e6621ba09b714d311d72bfffae6dd73e521a7c6bae02e24c98c3689? s=60&d=retro&r=g) ### 󠀁[Everything works great](https://wordpress.org/support/topic/great-plugin-work-perfectly-3/)󠁿 [mpojalow](https://profiles.wordpress.org/mpojalow/) Июль 19, 2021 2 replies After the last update, everything works, thank you. Niestety teraz bez pracy jestem finansowo pod kreską, kiedy to się zmieni obiecuję przesłać wsparcie. Dziękuje za Twoją pracę. ![](https://secure.gravatar.com/avatar/ca19624a11d786c35fb7364bf5ccdb12a96ae676f0151bba3b4e3d0629cd24b3? s=60&d=retro&r=g) ### 󠀁[Does not work Php 7.0.14](https://wordpress.org/support/topic/does-not-work-php-7-0-14/)󠁿 [brandjuh](https://profiles.wordpress.org/brandjuh/) Январь 4, 2017 exif_read_data() error can nog go into settings. [ Read all 13 reviews ](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/) ## Contributors & Developers “Geo2 Maps Add-on for NextGEN Gallery” is open source software. The following people have contributed to this plugin. Contributors * [ Pawel ](https://profiles.wordpress.org/pablo2/) * [ frest.de ](https://profiles.wordpress.org/frestde-1/) [Translate “Geo2 Maps Add-on for NextGEN Gallery” into your language.](https://translate.wordpress.org/projects/wp-plugins/nextgen-gallery-geo) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/nextgen-gallery-geo/), check out the [SVN repository](https://plugins.svn.wordpress.org/nextgen-gallery-geo/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/nextgen-gallery-geo/) by [RSS](https://plugins.trac.wordpress.org/log/nextgen-gallery-geo/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### V2.1.6 – 10.02.2026 * Update: Corrected conversion of GPS coordinates read from XMP. Added support for less likely occurring coordinate formats. #### V2.1.5 – 25.01.2026 * Update: Support added for WebP files created with an older library Adobe XMP Core 7.0 * Bugfix: Mistake corrected which prevented extracting WebD metadata from EXIP chunk. #### V2.1.4 – 21.01.2026 * NEW: Added support for reading GPS and EXIF metadata from WebP images. * NEW: Added caching of galleries, albums and images data including EXIF and GPS metadata using WordPress object cache and transients for faster repeated access. * NEW: Added options to disable EXIF caching and set cache duration (TTL). * Update: Settings page moved to main menu tools from NextGEN 4.0 submenu. * Update: Thumbnails size acquired from meta data if present. * Update: Removed symbol |” from Fancybox 3 Bottom Caption Panel * Bugfix: Deactivation when no NextGEN Gallery does not crash WordPress. * Bugfix: Fancybox 3 content is not overlapping slides any more. #### V2.1.3 – 17.11.2025 * Update: Amended code to show/hide loader during Geo2 Maps Ajax request only. * Update: CSS amended. Map on demand button is slimmer now. * Update: Added an option to acquire time from GPSTimeStamp if DateTime* not available * Bugfix: Added option to disable shortcodes on admin pages to prevent slowdown. * Bugfix: Error handler amended when reading EXIF data to log errors instead of echoing in ajax requests to prevent potential slowdown. #### V2.1.2 – 02.09.2025 * Update: Exif date-time will be acquired from GPSTimeStamp if not otherwise available. * Bugfix: Improved compatibility with some server not decoding url from a request. * Bugfix: Added check for undefined NGG global variable in situation when only this plugin is activated. #### V2.1.2 – 02.06.2025 * Update: Added compatibility with the latest WordPress Themes * Bugfix: Ajax URL validation improved * Bugfix: Removed shotcodes for lightbox type #### V2.1.1 – 02.01.2025 * Bugfix: Paths show infoboxes again #### V2.1.0 – 30.12.2024 * NEW: Maps engine migrated to Azure Maps API (new key required) * NEW: Azure Maps Fullscreen option added * NEW: Azure Maps 7 Pushpin Icon Types, Hover Scale, Primary and Secondary Color options added * NEW: Security increased: API Key acquired using Ajax request * New: Fancybox fullscreen, image change swipe and orientation resizing added * New: Slimbox 2 fullscreen, image change on scroll, swipe and orientation resizing added * New: Fancybox and Slimbox 2 close for browser back in history * New: Additional Route file formats supported: GeoJSON and Spatial CSV * New: Route files support included icon images * Update: Minimap module replaced with Azure Maps Overview Map * Update: Maps Styles updated * Update: Routes parameters updated * Update: Fancybox scrolling using jquery.mousewheel-3.0.4.js not compatible with many themes replaced * Update: Fancybox 3 shows gallery title and ID in hash * Update: Fancybox and Slimbox 2 do not move map any more on key left or right * Update: Unsupported Bird’s-eye view, copyright and showTermsLink removed * Bugfix: Fancybox 3 option: Prevent bottom caption to overlap the content is now working #### V2.0.9 – 24.06.2024 * Update: JIG description corrected in options * Bugfix: Thumbnails full filename acquired from pictures meta_data in database prevents incompatibility with older file naming #### V2.0.8 – 19.11.2023 * NEW: Pictures in galleries are now sorted in the same way as in the NextGEN Gallery * Update: Recommended error handling added for Exif read data * Bugfix: Excluding images in galleries works again #### V2.0.7 – 17.11.2023 * Update: AutoMap function now shows galleries on a map if no albums are found * Update: Security improved * Update: Code fully aligned with WordPress coding standards * Bugfix: All PHP warnings resolved * Bugfix: All reasonable WordPress standards check warnings resolved * Bugfix: Several bugs found and resolved * Bugfix: Infoboxes should not change location * Bugfix: Worldmap pushpins or thumbs will not open a missing page #### V2.0.6 – 17.10.2022 * Bugfix: Many PHP warnings resolved * Bugfix: array_key_exists() error resolution implemented #### V2.0.5 – 04.05.2022 * Update: How to create Gallery Map with a Shortcode added to the General tab * Update: Map options description amended * Update: Added compatibility with PHP 8.0 * Bugfix: Map created with a Shortcode with route path only searching unnecessarily for any galleries in a page content corrected * Bugfix: CSS corrected #### V2.0.4 – 21.08.2021 * Update: New map options have been added to hide parts of map interface * Bugfix: Shortcode parameters containing capital letters not working * Bugfix: Loaded route files with shapes with balloon description not showing Infobox correctly #### V2.0.3 – 15.05.2021 * Update: Slimbox 2 code slightly improved, version updated to 2.06 * Bugfix: Plugin slug amended to match WordPress old plugin slug * Bugfix: Slimbox image counter now shows numbers correctly * Security fix : unserialize() function removed creating PHP object injection vulnerability #### V2.0.2 – 04.05.2021 * Bugfix: Reference to CSS file corrected * Bugfix: Reference to removed examples.php removed #### V2.0.1 – 03.05.2021 * NEW: Bing Maps API key and MapQuest API key authentication process added with notification messages * NEW: Activation status added for Bing Maps and MapQuest services * NEW: Upload media button added for the route file * Changed: Bing Maps API key field moved to the General” tab, description amended * Update: Wp-color-picker-alpha Javascript updated to version 3.0.0 * Bugfix: Remains of the old code removed causing plugin to crash for some users * Bugfix: Deactivation warning enabled * Security fix : all user entered data is now validated #### V2.0.0 – 02.03.2021 by Pawel Block * NEW: Slimbox 2.04 (with a resize image box option) and Fancybox 3 Lightbox plugins to preview images * NEW: Fancybox 3 Bottom Caption Panel with EXIF information * NEW: Thumbnails customize options * NEW: Additional Auto Mode and Worldmap options * NEW: Customise options for Lightboxes and Infobox * NEW: Added support for GPX, XML, KMZ, KML, GeoRSS files * NEW: Customise options for shape from GPX, XML, KMZ, KML or GeoRSS files * NEW: Better plugin security * NEW: Many new options to create and customize maps * NEW: Create maps with specific photos * NEW: Full screen button for maps * Changed: Redesigned admin options panel * Changed: Code updated to support Bing Maps API V8 * Changed: Thumbnails generated using HTML5 canvas * Changed: Geocoding updated, Google geocoding removed to not violate Google API policy * Changed: Mini Map module updated * Changed: Preview Map removed on WordPress request #### V1.0 – 05.09.2012 by Frederic Stuhldreier * NEW: Shortcode system with several new options (map-size, map-style, thumbnails, single pictures, Ajax, etc.) * NEW: Thumbnails styled using CSS 3 or phpThumb() class * NEW: Activate and deactivate the maps dashboard, minimap and scalebar using the admin panel or shortcodes * NEW: Change style of marked routes using the admin panel * NEW: .GPX support for route-mode * NEW: Include your maps using AJAX * NEW: Set a map id for individual styling * NEW: Lightbox integrated (Fancybox, Slimbox 2) * NEW: Lightbox AJAX request for other photos (Worldmap mode) * Changed: Admin panel sub-menu now located in NextGen Gallery menu * Changed: Significantly reduced number of SQL queries * Changed: >1 map / post now possible * Changed: Use stored EXIF data, if available * Bugfix: Example map don’t work * Bugfix: Save options bug #### V0.6 – 13.05.2012 * NEW: Use [geo2] shortcode everywhere by choosing the gallery-ID: [geo2 id=Gallery- ID] * NEW: Worldmap-shortcode: [geo2 worldmap] * NEW: Preview Map * NEW: Choose between pushpins or thumbnails * Changed: Worldmap works faster, coordinates bug fixed * Changed: Easy gallery linking (Worldmap) * Bugfix: Broken maps, wrong data on some servers #### V0.5 – 21.04.2012 * NEW: Show advanced EXIF data * NEW: Album support * Bugfix: Exif_read_data used URL instead of a path (don’t work on a few servers) * Bugfix: Wrong coordinates, fixed and improved * Changed: Shortcode [geo2] works faster * Changed: Include via function improved * bugfix : Don’t show shortcode [geo2] #### V0.4 – 13.03.2012 * NEW: I18n * NEW: Added languages: german, english * NEW: Disable geocoding (options panel) * Changed: Auto-mode-> usage of filter ngg_gallery_output (much faster, no sql needed any more) * Changed: New options panel * Bugfix: Route-mode enabled * Bugfix: Geocoding error (Nominatim) #### V0.35 – 05.03.2012 * Bugfix: Fixed some bugs (route-mode) ## Meta * Version **2.1.6** * Last updated **2 weeks ago** * Active installations **100+** * WordPress version ** 3.0.1 or higher ** * Tested up to **6.9.4** * PHP version ** 7.2.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/nextgen-gallery-geo/) * Tags * [gallery](https://os.wordpress.org/plugins/tags/gallery/)[gps](https://os.wordpress.org/plugins/tags/gps/) [map](https://os.wordpress.org/plugins/tags/map/)[nextgen](https://os.wordpress.org/plugins/tags/nextgen/) [photos](https://os.wordpress.org/plugins/tags/photos/) * [Advanced View](https://os.wordpress.org/plugins/nextgen-gallery-geo/advanced/) ## Ratings 3.3 out of 5 stars. * [ 5 5-star reviews ](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/?filter=4) * [ 1 3-star review ](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/?filter=3) * [ 2 2-star reviews ](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/?filter=2) * [ 3 1-star reviews ](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/nextgen-gallery-geo/reviews/) ## Contributors * [ Pawel ](https://profiles.wordpress.org/pablo2/) * [ frest.de ](https://profiles.wordpress.org/frestde-1/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/nextgen-gallery-geo/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.paypal.com/donate/?hosted_button_id=7JWUJ2J9RXWYU)