Title: Simple Location
Author: David Shanske
Published: april 7, 2015
Last modified: februari 25, 2026
---
Search plugins
# Simple Location
By [David Shanske](https://profiles.wordpress.org/dshanske/)
[Download](https://downloads.wordpress.org/plugin/simple-location.5.0.24.zip)
* [Details](https://pap-aw.wordpress.org/plugins/simple-location/#description)
* [Reviews](https://pap-aw.wordpress.org/plugins/simple-location/#reviews)
* [Development](https://pap-aw.wordpress.org/plugins/simple-location/#developers)
[Support](https://wordpress.org/support/plugin/simple-location/)
## Description
Supports adding geo coordinates, a location taxonomy, and a textual location description
to a post, comment, user, or attachment. Supports adding weather data to a post
or to a widget based on location.
Offers choice of map displays. It supports retrieving
location using the HTML5 geolocation API by default. Clicking the location icon
or ‘Lookup Location’ will retrieve the location.
As it stores the GeoData in the classic WordPress format, Geodata can also be added
from other plugins.
Automatically saves location data from image metadata when uploaded as well.
Offers the opportunity to change the displayed timezone on a per-post basis for
those posts from far off locations and set this based on the coordinates of the
location.
While Gutenberg compatible, this is not built for Gutenberg.
### Privacy and Data Notice
Simple Location stores location and weather data inside posts, attachments, comments,
and term meta…optionally other post types. This data respects a public, private
or
protected setting. Attachment data is automatically extracted from images if
location is present, which could be extracted by any third-party downloading the
picture unless removed. For all other data, it is provided by the user, who decides
its ultimate use. Location data is made available through a geolocation provider…
the default is currently HTML5 browser geolocation, for which the user must give
consent to share). Other information is secured through use of third-party APIs
to identify a location, calculate elevation, display maps, and weather conditions.
### Locations and Venues
Locations uses WordPress taxonomies to allow you to generate an archive page of
all posts from that location and giving it a permalink on your site. Locations are
meant to reflect a more general
location…for example, “Here are posts I made in
California.”
Locations are divided by administrative areas. The hierarchy for locations is:
*
Country * Region – state, county, or province level. * Locality – city, town, or
village level
You can choose to display the location over the textual address field. There is
an option in settings to change this behavior.
The reverse geocoding system attempts to consistently retrieve the country code,
region code, and locality for the location and add them to the location taxonomy.
This can be potentially problematic, as if the returns
from the locations added
aren’t consistent, it will duplicate and explode the list of terms. This is the
same issue that has held back venues.
Locations are matched using the country code, region code, and locality field, and
therefore, you can edit the displayed name or the region code without issue. Due
to matching issues, you may have to make some manual changes and there may be some
occasional duplication.
There is no top level Location page, /location included in the plugin. You can create
a page at this location and use a custom template to allow it to show a list of
your locations.
Venues are meant to reflect a specific location, such as a business or point of
interest. Venues were originally set up as a taxonomy, and were in the plugin unimplemented
for several versions. However,
due to various changes since that was set up, they
were switched to a custom post type. Under this setup, each venue is represented
by a URL on the site that posts can be linked to. The URL contains information about
the venue.
### Zones
Zones allow for geofencing. You can set coordinates and a radius around them. If
you set location to a place within a zone, the default behavior is to replace the
location
with a preset Name and hide the coordinates. This allows you to protect
private locations such as your home, or your place of business. For Micropub, it
will set the location as protected if the location is in the zone and the location-
visibility property is not set. For the post editor in WordPress, looking up the
location of an item inside the zone will result in the visibility being set to protected
and the name being set to the zone name. This can be overridden.
Zones are replaced as of 5.0.0 with Private Venues
### Weather
Weather consists of at minimum the current conditions and temperature but includes
future parameters for use such as pressure, wind speed, wind direction degree, etc.
Weather widgets are available
that can be set to a specific location, a user, station
ID, or airport code. Station ID is available from supported providers for weather
stations, for example from a Personal Weather Station(PWS).
### Stations
Stations allow for using a custom data source for weather data. This source should
be a URL that returns a JSON object. When using the Custom Station provider for
weather, it
will look for when one of the stations defined is within 10km of your
current location. It will then use the return as the current weather conditions.
Please note that the return must be in the format documented in the code.
### WordPress GeoData
[WordPress Geodata](https://codex.wordpress.org/Geodata) is an existing standardized
way to store geodata about a post, user, comment, or term.
It consists of four fields: latitude, longitude, public, and address. This matches
up with the HTML5 Geolocation fields. The [W3C Geolocation Specification](https://dev.w3.org/geo/api/spec-source.html)
also provides for properties of altitude, accuracy, altitudeAccuracy, speed, and
heading, which may be stored. Map Zoom is also stored as a geodata property.
Timezone is also stored as a property and is derived from the location by default
or set manually.
In order to access private location information, the following custom capabilities
are added to WordPress:
* ‘read_{$object_type}_location’ – Whether or not a user
is allowed to read information locations for object types: posts, comments, terms,
users. A user is always allowed to read the location from their objects. * ‘edit{
$object_type}_location’ – Whether or not a user is allowed to edit information locations
for object types: posts, comments, terms, users. A user is always allowed to read
the location from their objects.
### Providers
The plugin is designed to be extensible and anyone could write a plugin that would
add additional providers.
* Map Providers are services that offer an API to retrieve maps, which are displayed
on posts with a location. Providers include MapBox, Google, Mapquest, HERE, LocationIQ,
Geoapify, TomTom, and Bing.
* Geocoding Providers take geo coordinates and look up the actual location/address
for textual display. Geocoding Providers include Nominatim, HERE, the Mapquest
hosted version of Nominatim, Google, Bing, LocationIQ, OpenRoute and Geonames.
They also support looking up coordinate for physical addresses
* Venue providers, similar to Geocoding providers, search for locations from coordinates,
however, instead of returning street addresses, or municipality, it returns a
list of places or venues.
* Elevation Providers optionally derive the elevation from an API when not available.
Elevation is used to estimate altitude and adjust estimated sunrise/sunset levels
accordingly.
* Location Providers attempt to determine your location to add it to a post. Providers
include HTML5 Browser Geolocation, a Provider that takes the location setting
out of the author profile, a provider that returns the exact
location of a three
letter airport code, and [Compass](https://github.com/aaronpk/Compass), a self-
hosted option for storing your location.
* Weather Providers retrieve weather data about your location and include OpenWeatherMap,
Pirate Weather, Dark Sky, Weatherstack, WeatherBit, HERE and the US National
Weather Service. HERE, Pirate Weather, Dark Sky, WeatherBit, and Weatherstack
do not support stations. There is also an option for custom station URLs that
must return the properties as they are stored in WordPress.
** The National
Weather Service(US) uses their station lookup API to find the closest weather
station, and uses weather from there. Therefore, if this returns no options,
if you are outside the US, it will return no weather. ** The Met Office(UK) uses
the distance from your current location to the nearest UK weather station and
finds the closest one. However, if the nearest station is more than 100km away,
it will return nothing. ** For Weather services like the NWS, Met Office, and
the Custom Provider, where coverage is not worldwide, if nothing is found, a
fallback provider can be set and used.
## FAQ
### What are the requirements to use this plugin?
API Keys are required to use certain services.
* [Google](https://developers.google.com/maps/documentation/javascript/get-api-key)*
[Mapbox](https://www.mapbox.com/help/create-api-access-token/) – To retrieve style
list inside the UI, you need a token with the styles:list scope * [Bing](https://www.bingmapsportal.com/)*
[OpenWeatherMap](http://openweathermap.com/api) * [MapQuest](https://developer.mapquest.com/)*
[HERE](https://developer.here.com/) * [Compass](https://github.com/aaronpk/Compass)*
[Weatherstack](https://weatherstack.com) * [Weatherbit](https://www.weatherbit.io/api/weather-current)*
[GeoNames](https://www.geonames.org) – requires a username * [LocationIQ](https://locationiq.com/)*
[Met Office UK](https://www.metoffice.gov.uk/services/data/datapoint) * [OpenRoute Service](https://openrouteservice.org/)*
[GeoApify](https://geoapify.com) * [Visual Crossing](https://www.visualcrossing.com/)*
[Meteostat](https://meteostat.net/) * [Pirate Weather](https://pirateweather.net)*
[TomTom](https://developer.tomtom.com/) * [AerisWeather](https://aerisweather.com/)–
Individuals who share their personal weather station data with PWSWeather.com are
offered a free contributor account.
At this time, all map services require an API key, but most permit limited non-commercial
use.
Nominatim does not require an API key, but it does ask for an email address,
which will be the admin email of the site If not provided there will be no map displayed
regardless of setting, reverse geo lookup will not work Without a weather provider
this service will not work.
API Keys may have free limits, or may incur fees if overused. This plugin only uses
a request when you post, which is usually well within the free tier which is usually
thousands of requests. In all cases, you must comply
with the provider’s terms
of use.
The appropriate API keys should be entered in Settings->Simple Location or will
move to Indieweb->Location if the Indieweb plugin if installed.
### How do I add support for location to a custom post type?
add_post_type_support( ‘geo-location’);
add_post_type_support( ‘weather’ );
The software uses two custom features to declare that the post type supports these
features, otherwise the location and weather features do not show in the editor.
### Why are my maps served from the provider instead of saved as images to my site?
The terms of service of most map providers expressly forbid this. While the likelihood
of one of these providers coming after an individual is slim, this would be a violation
of WordPress plugin guidelines.
This is why the plugin does not save maps to the
media library. The only self-serve option being offered at this time is to self-
host a caching static map API endpoint.
### What is the custom map provider?
The custom map provider is an endpoint you provide yourself. You can install and
use the repository [here](https://github.com/dshanske/Static-Maps-API-PHP), which
is a fork of a project by [Aaron Parecki](https://aaronparecki.com).
The custom
provider was designed around the parameters in this code. All the commercial static
map APIs used assemble the pieces of a map from public tile servers, which is what
this code does. While the code allows for multiple tile sources, please ensure compliance
with their licenses. At the least, most of them require attribution.
### What is the custom weather provider?
This allows you to use a custom endpoint that returns current weather conditions
in json, using the property names used by this plugin, which can be found outlined
in the class-weather-provider.php file. The configuration for this
takes a URL
and an ID. So you could run a script that generates a static page anywhere from
any source with this data.
### Which providers support historic weather data?
Currently, only Visual Crossing supports historic weather data on their basic plan.
Meteostat consists solely of historical data and has no current data.
### What is the fallback weather provider?
Several providers, including the custom provider, the National Weather Service(US),
and the Met Office(UK) only provide limited locations for retrieving weather data.
This specifies where to look if the first provider fails.
This may be replaced
with better logic in future.
### Is this compatible with the WordPress mobile apps?
Simple Location uses WordPress Geodata to store location, as does the WordPress
app. So setting location with the app should allow it to be displayed by Simple
Location. The only major difference
is that whether or not a location is public
is set with either 0 for private or 1 for public. The spec implemented states a
non-zero number is considered public. This plugin adds the option of 2, also known
as protected, which shows a textual description of the location but does not display
a map or geographic coordinates.
However, now that the WordPress apps no longer support location, this may be moot.
### The Location Icon does not retrieve my location.
Chrome Users: Retrieves the location using the HTML5 geolocation API(available in
your browser) will not work on Chrome if your website is not secure(https). This
is a Chrome decision to ensure safe control of personal data.
You can take advantage of the other built-in location providers, for example, one
uses the location of the user or create your own location provider as a separate
plugin.
### How can I update the location of my user profile?
You can do so under your user profile or alternatively update using a REST API endpoint.
By posting to `/wp-json/sloc_geo/1.0/user` with the latitude, longitude, altitude
parameters, or with a geojson body, will
update the user associated with the credentials
you provide to the REST API.
### How can I access the location or weather data on the frontend?
There are REST API endpoints to retrieve the data so it can be used in the admin
under the namespace `/wp-json/sloc_geo/1.0`:
* /timezone which will return timezone
data for a latitude/longitude or airport code * /weather which will return the weather
for a latitude/longitude or station ID * /geocode which will return the address
information for a latitude/longitude and optionally add the weather * /lookup which
will return the current location for a user based on the location provider * /airport
allows search for an airport by IATA code, ICAO code, or Municipality. Used for
the airport location search * /map which will return static map data for the provided
latitude and longitude
### What is Compass?
[Compass](https://github.com/aaronpk/Compass) is a GPS tracking server that stores
data in flat files. The instructions for installation are available in the GitHub
repository. GPS
data can be sent to it from iOS or Android devices using various
apps.
### How can I show a list of posts tagged with a location?
You can filter any query or archive by adding `?geo={all|public|text}` to it to
show only public posts with location. Adding /geo/all to the homepage or archive
pages should also work
### How can I see a map of all the locations in an archive page?
If you add /map to any archive URL, for example, example.com/2019/map it will return
a template with a map view of that archive. It uses a default template built into
the theme.
Being as styling this would not be customized to your theme, you can
add a map-archive.php file to your theme to customize this. For taxonomies, use /
map/taxonomy/term.
### JetPack offers Location Display, why do I need this?
JetPack only began offering location display in 2017, 3 years after this plugin
was created. This plugin disables their implementation as it created conflicts.
They do not offer the features this plugin does and their goal is a minimal implementation.
### Why am I seeing location on private posts with the notation Hidden?
This appears to users who can read private posts when logged in. It does not appear
when not logged in. The same applies to the location taxonomy. If you are not logged
in, or
are logged in and don’t have the read_private_posts permission, you won’t
see posts with private locations.
### How can I report issues or request support?
The Development Version as well as support can be found on [Github](https://github.com/dshanske/simple-location).
### How can I add support for ___ ?
Simple Location has the concept of Providers. Providers are an abstract class that
you can implement to take information from one format into the one Simple Location
understands.
The plugin offers providers for: * Geolocation – Looking up an address
from coordinates or vice versa * Location – By default this uses your browser to
lookup your location but you can alternatively tap into a service to get your current
location, perhaps from your phone * Weather – Retrieves weather based on location
or station ID * Map – Provides maps for display
### What icons are used here?
* [Weather Icons](https://erikflowers.github.io/weather-icons/) are used for most
of the weather options.
* [Font Awesome](https://fontawesome.com/) is used for the transportation icons.
* [Simple Icons](https://simpleicons.org/) supplies the transportation brand icons.
## Reviews
### [BUG: Prevents Comment Editing (Deletion works)](https://wordpress.org/support/topic/prevents-comment-editing-deletion-works/)
[Dennis Bareis](https://profiles.wordpress.org/dbareis/) november 11, 2023
Not sure how long this has been happening but this plugin prevents comment editing
from working. The green “Update” button does nothing. I am doing this on a custom
post type (with PODS). Console tools shows this message being generated: An invalid
form control with name='venue_id’ is not focusable. venue_id” id=”venue_id” step=”1″ min=”1″ value
=”0″> If you expand Location (click EDIT) then click edit it says ” Venue: must
be greater than or equal to 1″
### [Hidden Treasure](https://wordpress.org/support/topic/hidden-treasure-3/)
[kartguru](https://profiles.wordpress.org/kartguru/) februari 10, 2021
Doesn’t look like much but is doing a fair bit under the hood. It’s simple yet very
effective and well thought out.
### [Great](https://wordpress.org/support/topic/great-11201/)
[dave3535](https://profiles.wordpress.org/dave3535/) april 14, 2020
Great Plugin I utilize it a great deal. I would like to be able to use it on my
pages too not just post though. I love the ease of use and the simplicity.
### [Lovely default options](https://wordpress.org/support/topic/lovely-default-options/)
[LewisCowles](https://profiles.wordpress.org/lewiscowles/) april 13, 2020
I really appreciated that the default was for private access and using Open providers.
I downloaded and installed using the UK MetOffice provider. Thanks so much David
### [Simple but very useful](https://wordpress.org/support/topic/simple-but-very-useful-15/)
[Khürt Williams](https://profiles.wordpress.org/khurtwilliams/) augustus 10, 2019
I can’t imagine using the check-in post-kind without this. I love seeing a map displayed
below my posts.
### [Very good](https://wordpress.org/support/topic/very-good-2834/)
[Interludic](https://profiles.wordpress.org/interludic/) januari 24, 2018
Thank you! Only took minutes to setup and do what it says and what i need. However
i would like to change the way You can filter any query or archive by adding ?geo
={all|public|text} to it to show only public posts with location. Adding /geo/all
to the homepage or archive pages should also work. Instead a list of posts, a map
with all the markers that link to the post would be so cool!
[ Read all 8 reviews ](https://wordpress.org/support/plugin/simple-location/reviews/)
## Contributors & Developers
“Simple Location” is open source software. The following people have contributed
to this plugin.
Contributors
* [ David Shanske ](https://profiles.wordpress.org/dshanske/)
[Translate “Simple Location” into your language.](https://translate.wordpress.org/projects/wp-plugins/simple-location)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/simple-location/),
check out the [SVN repository](https://plugins.svn.wordpress.org/simple-location/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/simple-location/)
by [RSS](https://plugins.trac.wordpress.org/log/simple-location/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 5.0.24 ( 2026-02-25 )
* Fix issues with Last Seen Widget
* Refresh data
* Identify short circuit logic that was not triggering
* Fix variable naming
* Toggle srcset to false by default due load
* Update weather providers to latest APIs where possible
* Fix text domain warning error
#### 5.0.23 ( 2024-02-02 )
* Fix issues with media metadata saving
* Save location taxonomy for images
* Fix unset variables in HERE provider
* Refresh data files(airports, geo subdivisions, etc)
#### 5.0.22 ( 2023-12-25 )
* Fix issue where dropdown filter was not working when value set to no filter.
* Limit venues when you change location pulldown.
#### 5.0.21 ( 2023-12-23 )
* Fix fatal error when no venue
* Read OpenMapQuest as a Geo Provider as no longer available
* Add dates to map archive view
* If missing location but post has a venue, set the location of the post to the
venue’s location
#### 5.0.20 ( 2023-12-17 )
* Dropdown for Venue will now on new edit load only, limited to venues at that
location
* Temporarily disble sunset adjustment by elevation due to PHP8 deprecation of
date_sunrise/sunset. Need to write wrapper in future
* Dropdown filter for location taxonomy added
* Improve some strings
#### 5.0.19 ( 2023-12-12 )
* Pulldown will set option by default
* Fix micropub integration to add additional check
#### 5.0.18 ( 2023-11-11 )
* Update dependencies
* Support Widgets in Legacy Widget Block
* Fix Venue Being Set to 0
* Switch venue to a pulldown. Would like to link it to location at some point,
so it only shows venues in that region.
#### 5.0.17 ( 2023-10-02 )
* Refresh dependencies
* Bump minimum PHP to 7.0
#### 5.0.16 ( 2023-07-15 )
* Fix issue with missing AQI icon
#### 5.0.15 ( 2023-07-01 )
* Fix conflict with WooCommerce Subscription plugin
#### 5.0.14 ( 2023-06-03 )
* Fix undeclared variable
* Fix unclosed string
#### 5.0.13 ( 2023-05-02 )
* Fix issue with geoapify and bing map providers due calling old bounding box function
* Change signature of display name function for taxonomy to allow for multiple
arguments for display
* Fix issue with google marker display
* Check for ExifVersion before using it
#### 5.0.12 ( 2023-04-30 )
* Remove Dark Sky as API is turned off
* Fix several issues where errors occurred because a non-numeric value was passed
to a function that required a numeric one
* Check for existence of array properties before using them
#### 5.0.11 ( 2023-04-14 )
* Add code to store webmention location in comments previously handled by Semantic
Linkbacks
* Fix issue with typing in PHP8.1 causing errors
* Fix for no set map provider
#### 5.0.10 (2023-03-13 )
* Fix call to deprecated function
#### 5.0.9 ( 2023-03-12 )
* Fix issue with filter of location archives
#### 5.0.8 ( 2023-03-08 )
* Fix EXIF data issue
* Introduce attachement date function to get created time and use it to show this
in the attachment editor.
#### 5.0.7 ( 2023-01-10 )
* Minor bug fixes
* Add function to return child venues.
#### 5.0.6 ( 2023-01-02 )
* Add functions for parent venues and to extract media from posts made at venue
* Check error on return
#### 5.0.5 ( 2022-12-27 )
* Add count of posts attached to venues to list table
* Allow importing an address from associated posts to a venue
* Improve list table display
#### 5.0.4 ( 2022-11-25 )
* Add uid when updating the checkin property of a post
* Add location to post slug for venues to assist in disambiguation
* Add location to venue when displayed to assist in disambiguation
#### 5.0.3 ( 2022-11-13 )
* Add support to lookup location to update older posts with venue creation
* Update map archive to call get_location over custom code. Add arguments to get_location
to allow better customization for the map.
* Set map zoom level to building level if Micropub post is a checkin
* Allow for passing thorugh a zoom when creating a venue, otherwise building level
default
#### 5.0.2 ( 2022-11-12 )
* Add function to get posts for a specific venue
* Add function to retrieve venue type
#### 5.0.1 ( 2022-11-06 )
* Fix issue raising warning during block editor
* Fix strict typing on zenith
#### 5.0.0 ( 2022-11-05 )
* Remove Yandex as a supported provider.
* Add URL and documentation strings to all providers
* Refactor reused code in providers into traits.
* Separate Elevation into a separate provider category. The Elevation provider
is called by the Geo Provider when needed.
* Add additional error checks
* Introduce GeoApify for Geolocation
* Split off EXIF data enhancement into a separate file
* Move several geo faunctions to global scope.
* Add a series of global functions to get/set geo and weather data which are also
pluggable to different storage locations
* Separate weather and geo into two separate sets of functions
* Set the weather condition to a code instead of storing icons and summary. Retain
summary and icon for backcompat
* Introduce Venue as a Custom Post Type
* Replace Zones with Private Venues
* Automatically create venues when checking in using Micrpub.
* Make default for displaying location on posts the venue name and link, then location
taxonomy, then address field.
#### 4.5.0 ( 2022-06-17 )
* Adjust queries
* Update dependencies
* Show timezone on the post edit page when does not match site timezone
#### 4.4.15 ( 2022-01-26 )
* Add airline brand icons
* Add labels now customizable for location taxonomy
* Update dependencies
#### 4.4.14 ( 2021-11-12 )
* Fix for posts without location causing error
* Added rewrite for map and location taxonomy together. /maps/location/us for example
* Added option for showing taxonomy in the location display over the address field.
#### 4.4.13 ( 2021-11-02 )
* Additional type fixing
#### 4.4.12 ( 2021-10-30 )
* Fix minor bug
* Update airport data
#### 4.4.11 ( 2021-09-28 )
* Fix issue with protected functions causing errors
* Remove duplicative data for country and region conversion
* Add unit tests
* Add flags to country pulldowns
* Add flags to Archive Views
#### 4.4.10 ( 2021-09-06 )
* Set Default Time for Posts based on the User Timezone field.
* Ensure Last Seen Does Not Update if Off by More than Ten Minutes
* Update Rest Field return to show all returns, but only if the information is
public, otherwise it is blank.
* Add timezone to REST comment endpoint
* Remove empty returns from location data in post, comment, and user endpoints
* Add custom capabilities
#### 4.4.9 ( 2021-08-21 )
* Refresh of Map Providers based on latest API parameters
* Introduction of Max Height, Width, and Zoom parameters to prevent going larger
than provider supports
* Introduction of TomTom maps
* Adjustment of icon styling
#### 4.4.8 ( 2021-07-23 )
* Refresh of dependencies and compatibility check with WP5.8
#### 4.4.7 ( 2021-05-14 )
* Add Pirate Weather( https://pirateweather.net ) as a weather provider. I like
to support independents.
#### 4.4.6 ( 2021-04-05 )
* Hide localities in parent list.
* Set location taxonomy in Micropub.
* Move location taxonomy into same box as rest of details.
#### 4.4.5 ( 2021-02-27 )
* forgot to commit necessary data files in 4.4.4
#### 4.4.4 ( 2021-02-27 )
* Fix issue where saving terms places other than the admin causes data loss. This
also fixes data loss when using a taxonomy merge tool.
* Switch from querying for the term meta to determining type of location by hierarchy.
* Check permissions before allowing the edit of the term.
* Add region select pulldown which will be shown unless the value of the region
is not on the list.
#### 4.4.3 ( 2021-02-13 )
* Fix issue with saving Term Metadata
* Add list location function to output a list of used locations. Currently wrapper
around wp_list_categories
* When you add a new term it automatically refreshes the entire list of locations
so the new term will appear properly in the hierarchy.
* Additional unit testing.
#### 4.4.2 ( 2021-02-09 )
* Reworking of the region search code using new data sources to try to get some
consistency between providers.
* Add option to the debugger to not add new term, to allow for testing.
* Revamp of UI based on feedback to make it less fragile.
#### 4.4.1 ( 2021-02-07 )
* Location was only being shown in DEBUG mode
* When a match for region code was not found the code was creating a region with
a name but no code, which meant duplication. Going forward, it will use the full
region name. It will also try additional matching to find the code.
* When looking up the location on an existing post, it was setting everything to
private. Going forward, only if not already set.
* Display Name function now links each part of the location to the term page for
it.
* Switch rewrite for taxonomy maps to /map/taxonomy instead of taxonomy being at
the end.
* Update custom station provider to check timestamp and support future station
historic weather.
#### 4.4.0 ( 2021-02-07 )
* Rename the Mapquest provider to OpenMapquest as there is an alternative Mapquest
API.
* Make the Mapquest open provider and LocationIQ provider a descendant of the nominatim
provider as both return the same data.
* Introduce MapQuest geolocation provider, separate from openmapquest.
* Fix issue with Google reverse lookup return.
* Review and update all reverse/geocode lookups from API documentation.
* Standardize country codes in all returns to the iso2 coding.
* Add support for converting iso3 to iso2 country codes.
* Support generating street addresses for countries where the house number appears
after the street name.
* Improve display location name generation from address components.
* Add Pelias Provider. OpenRoute is actually a hosted instance of the Pelias Geocoder,
and now inherits its conversion functionality.
* Standardize the addition of region codes, special casing the US States and Canadian
Provinces, but using a global list as well.
* If there is no address or locality then display the full region name instead
of the code.
* Add home country option which will hide the country from the location display.
* Introduce Location Taxonomy.
* Introduce bulk lookup capability.
* fix issue where Micropub lookup did not add historic data.
#### 4.3.0 ( 2021-01-09 )
* Support for historic weather data in providers who offer it, see readme for details.
* Addition of Visual Crossing as a provider. Visual Crossing is the first provider
which in addition to 1000 queries per day, offers a pay per use model past that
as opposed to a monthly subscription.
* Addition of Meteostat as a provider. Meteostat is free for use, but is set up
for historical weather data only.
#### 4.2.3 ( 2021-01-03 )
* Additional error checking
* Improved mapping for the Custom Station provider
#### 4.2.2 ( 2021-01-02 )
* Measurements are always stored in metric units, and were displayed on the front
end in imperial units when set.
** This version will now show it in imperial
on the backend and convert to metric for storage after the fact.
* ?sloc_units=imperial or ?sloc_units=metric will override the display to show
one or the other if added to any URL
* The units displayed will now show in the labels if edited in the Post UI.
* All weather markup now uses a common function and label list.
#### 4.2.1 ( 2020-12-10 )
* Custom station provider said it would use the station within 10km, but was actually
set to 100km. Fixed.
#### 4.2.0 ( 2020-11-24 )
* Introduce custom weather station provider
* Add additional properties to the possible list of weather properties, inspired
by the Weewx schema.
* Add fallback weather station setting which allows for the system to try a second
weather option if the first fails. This is normally for the providers with limited
geographic coverage.
* Fix issue where errant space in filenames made waxing and waning gibbous icons
fail to appear.
#### 4.1.12 ( 2020-11-01 )
* Deprecate cache_key and switch to using key generated by class name. Cache will
be enabled now by whether cache_time is set to 0 or not.
* Sanitize coordinates when setting providers
* Add caching functions to simplify weather provider caching.
* Cache Time is now an Option for All Widgets
#### 4.1.11 ( 2020-10-16 )
* Do additional error checking to ensure timezone notices do not appear.
* Start process of fixing caching.
#### 4.1.10 ( 2020-10-11 )
* Do not store timezone string if the offset matches the site timezone.
* Do not store icon if it is the default icon.
* Check for valid map provider before attempting to use it.
* Sanitize REST API inputs
* Trim whitespace on widget inputs
* Switch OpenWeather Map to use the OneCall API.
* Adjust NWS and OpenWeatherMap to Store Wind Gust Info.
* Centralize static map img tag code and add lazy loading flag and srcset option.
#### 4.1.9 ( 2020-08-15 )
* Minor bug fixes and check to ensure compatible with WordPress 5.5
* Dependency refresh
#### 4.1.8 ( 2020-07-12 )
* Add additional sanity checks due reports of errors caused by removal of provider.
* Astronomical option now shows for all widgets, not just one.
#### 4.1.7 ( 2020-07-12 )
* Minor fix for failure in previous release which is not showing up in testing.
#### 4.1.6 ( 2020-07-12 )
* Introduce Custom Map Endpoint, based on a [fork](https://github.com/dshanske/Static-Maps-API-PHP)
of a library by @aaronpk
* Clean up markers and other settings on the map provider to look more consistent.
* Moon phase code redone, and moonrise/moonset added
* Fix is_day code
#### 4.1.5 ( 2020-07-04 )
* Wikimedia Maps is now deprecated. Their decision, not mine.
* OpenRoute Service is added as a geoprovider.
* GeoApify is added as a map provider.
* Yandex added as a map provider. Does not require an API key for limited use.
* Weather widgets all redesigned with new layout. Station and Airport widget now
inherited from weather widget so same design in each.
* Last Seen Widget Redesigned.
* Moon Phase added to Last Seen Widget.
#### 4.1.4 ( 2020-06-28 )
* Fix error message when timezone result has no timezone string
* Add ability to do map views of taxonomies and user archives
#### 4.1.3 ( 2020-06-24 )
* Fix issue where airport widget would only accept IATA codes(3 letters), not ICAO
codes(4 letters).
#### 4.1.2 ( 2020-06-12 )
* Fix fatal error on user page
#### 4.1.1 ( 2020-05-27 )
* AerisWeather is now a provider
* Add docblocks
* PHP5.6 now minimum
* Add additional icons
* Optimizations, refactoring, and bugfix
* Add the ability to change the location icon to various alternatives.
* Add support for retrieving airline data
* Improve airport data support
* Standardize units of measure
#### 4.0.6 ( 2020-04-12 )
* Update HERE to use API Key over prior app id system
* Update HERE Map Service to use new endpoint
* Add HERE Weather and Geolocation Service
* Added support for Met Office UK…using the nearest station
* Add debugger tab for geocode lookup and weather lookup
* Misc development fixes to remove duplicative code
#### 4.0.5 ( 2020-03-18 )
* Fix issue with timezone handling of photo EXIF data by allowing either timezone
string or object
* Fix issue with EXIF altitude handling
#### 4.0.4 ( 2020-02-17 )
* Update timezone handling in attachments
* Add timezone offsets to REST API
#### 4.0.3 ( 2020-01-26 )
* Minor bug fixes
* Fix precision of weather fields
* Fix incorrect function call
#### 4.0.2 ( 2019-12-22 )
* Extract more information from Compass normalize it and pass it to WordPress
* Extract flight information from Compass if in the properties and use this to
replace the place name with flight info
* Round weather and location data to 2 or less decimal places
* Ensure timezone is a string
* Introduce new location provider which will derive location from a 3 letter airport
code because why not
#### 4.0.1 ( 2019-11-24 )
* Switch from removing pagination to limiting it to 100 per page by default
* Filter query by location instead of filtering posts from the quantity afterward
#### 4.0.0 ( 2019-11-18 )
* Reimplement timezone handling using updated functions from WordPress 5.3 backported
to this plugin
* Enable UTC and offset override support provided you are using PHP5.5 or above
* Reenable the option for nominatim despite it being prone to denial but provide
the admin email address as requested by service
* Add support for comments using the timezone of the post they are part of
* APIXU is now Weatherstack.com
* Sunrise and sunset function now in astronomical calculation class and factor
in elevation to calculate visual sunset
* Last seen widget now shows local time, sunrise and sunset times and map optionally
* Add airport widget
* Support user update using geojson
* Add tabbed settings page
* Compass API is now a user not a global setting
* Add support for LocationIQ as a map and geo provider
* Add support for WeatherBit as a weather provider
* Add polyline encoder
* Add support for historical locations, currently only Compass supported, in the
Classic Editor
* Support generating a static map with multiple location markers for archive views
* Do not add current weather if publish date is not current
* Enhance HERE map styles
* Switch from default map width/height to width and aspect ratio
* Switch default map zoom to summary descriptions over numerical values
* Generate default map zooms when possible based on altitude or accuracy when available
* Update various form fields to use number over text types
* Add /map to archive pages and it will display a custom map archive page
* Misc validation checks to prevent PHP notices
* Fix timezone issues on attachments by using the location of the photo to update
the timestamp
* If no location is provided Micropub will lookup the location factoring in the
publish time if one is provided
#### 3.8.2 ( 2019-09-21 )
* Minor Fixes to photo improvements released in 3.8.1
* Prioritize determining timezone from location over published time when using
Micropub
#### 3.8.1 ( 2019-06-16 )
* Fix issue where hidden location showed in RSS feed
* Automatically lookup location for uploaded photos
* Automatically convert timestamp on photo to published property
#### 3.8.0 ( 2019-05-26 )
* Add Geonames as a Provider
* Fix issue with auto-location on micropub
#### 3.7.2 ( 2019-05-17 )
* Additional style fixes
* Add option to show maps on archive and home pages not just single
#### 3.7.1 ( 2019-05-12 )
* Fix reported issue with icons being oversized when loaded without style sheet
* Redid weather and location microformats markup. Temperature now marked up as
h-measure and location as h-adr
* Update formatting in widgets to not include microformats
#### 3.7.0 ( 2019-04-13 )
* Do not return maps if location is protected
* Set Micropub posts with location to public visibility
* Do not save raw weather data on Micropub
* Enhance post filter to include all visibilities
* Add location visibility column to posts
* Fix storage of timezone on Micropub entries
* Update airport data
* Add bulk edit post location visibility
* Automatically add private location on Micropub post
* Clean up data on loading settings page
#### 3.6.4 ( 2019-04-01 )
* Fix/update default map styles for Mapbox
* Add default map style now available for Bing
#### 3.6.3 ( 2019-03-31 )
* Add Compass as a location provider
* Add APIXU as a weather provider
#### 3.6.2 ( 2019-02-25 )
* Fix timezone data conversion when get_the_date is called with a $post object
* Fix micropub timezone storage to store name of timezone over entire timezone
object which messed up display
* Fix issue with default geographic options
#### 3.6.1 ( 2019-02-23 )
* Missing commit
#### 3.6.0 ( 2019-02-23 )
* Round altitude to nearest even number for display
* Minor bug fixes for PHP notices
* Add Wikimedia maps as a map provider. Link to their map site do not quite work
but the static maps could be cached in future
* Add setting to display altitude only if above a certain number of meters
* Add zones to encourage privacy
* Visibility returned in geo query if in zone
#### 3.5.3 ( 2019-01-04 )
* Fix bug in timezone scope causing Micropub to fail
* Fix sunset darksky error ( props @xavierroy )
* Rename Private to Hidden for logged in users to indicate location isn’t shown
if not logged in
* Show map on load not just on lookup
* Fix map zoom setting
* Fix properties not showing when post displayed in editor
* When HTML5 geolocation provider is set the rest endpoint will use the user location
is queried as you cannot use a browser option outside of the browser
#### 3.5.2 ( 2018-12-22 )
* Fix visibility issue finally
* Fix widget title issues
* Style changes/fixes( thanks @asuh)
* Add location provider that always returns the location in the author user profile
* Add endpoint to update the user location
* Show private or protected location if logged in as user who can publish posts
with the notation private
#### 3.5.1 ( 2018-12-19 )
* Did not merge in fix before pushing
#### 3.5.0 ( 2018-12-19 )
* Another attempt to fix the setting of private location by adding testing
* Enhance rest integration
* Add timezone endpoint
* Add geocode endpoint to replace reverse endpoint
* Add airport lookup using method used by @aaronpk
* Rename metric to SI to be more accurate as multiple measurements not just temperature
* Store measurements in SI(meters, celsius, etc) and allow for change to imperial
on the fly
* Store additional weather parameters
* Add sunrise and sunset parameters
* Split Weather Station into a Separate Widget
* Remove Station ID API settings in favor of widget
* Add support for the US National Weather Service as a weather provider. It finds
the nearest weather station and reports current conditions
* Update Micropub return to add weather even if there is not a location lookup
occurring
* Add Micropub query for location
* Removal of hidden underused feature that set timezone based on browser settings
* Fix of map endpoint and add map url to the reverse geocode endpoint as it is
merely a URL
* Map now displayed when location is looked up.
* Plugin will now work with Gutenberg, though not strictly built for it.
#### 3.4.1 ( 2018-11-02 )
* Fix for displaying map when altitude but no location is set
* Automatically update timezone based on location on Micropub posts
#### 3.4.0 ( 2018-10-27 )
* Fix for incorrect return when there is an error
* Nominatim began to block reverse traffic so added additional options for reverse
lookup.
* Map Providers and Geo Providers are now separated
* Unload Jetpack Geo Location which was added unknown to me in 2017. However added
compatibility functions to ensure functionality matches
* Declares post-type support for geo-location which is something the JetPack plugin
does
* Adds location meta tags
* Add sanitize function that ensures geo_public is always saved as an integer
* Empty address now causes plugin to display coordinates if not private
* Provider registration now done by function as opposed to filter
* Mapquests hosted version of Nominatim now offered but requires API Key
* Mapquest Static Maps now a supported map provider
* HERE Maps is now a supported map provider
* Google is now a supported reverse lookup provider
* Bing is now a supported reverse lookup provider
* Elevation/altitude in meters is now calculated using an Elevation API when not
supplied by the location provider
* DarkSky is now a supported weather provider
* Removal of the SLOC_PUBLIC constant in favor of this being stored in the options
table
* Default Location Visibility now allows all three options
* Display altitude over 500m
* Auto add weather and location textual description when coordinates are provided
#### 3.3.8 ( 2018-05-27 )
* Fix for jsonFeed error
#### 3.3.7 ( 2018-05-14 )
* Fix for jsonFeed privacy settings
#### 3.3.6 ( 2018-05-12 )
* Privacy and data collection statement
* Add geoJSON to JSONFeed
* Fix incorrect permissions for GEORSS
#### 3.3.5 ( 2018-04-15 )
* Minor location attachment storage changes
#### 3.3.4 ( 2018-03-27 )
* Fix issue when default is not set
#### 3.3.3 ( 2018-03-26 )
* Add markers to static map and map link for Mapbox
* Clean up URL generation code for static maps
* Update jstz dependency and set up scripted update for future
* Remove hard-coded options for provider selection and make code more dynamic to
allow third-party additions
* Add support for alternative geolocation providers in the backend. Currently defaults
to the HTML5 browser option in the frontend
* Weather now supported for non-SSL sites
#### 3.3.2 ( 2018-02-03 )
* Simplify and refactor metadata saving functionality
* Improvements to metaboxes ( props to @kingkool68 for contributions )
* Refactored location JS
* Add confirmation before clearing data
* Added loading spinner while retrieving location information
* Move location visibility and lookup to Publish Metabox
* Rename visibility settings in an attempt at clarity
* Auto-load weather when retrieving location
* Add start of function to retrieve location optionally on backend
* Icons change color when hovered over to indicate functionality
#### 3.3.1 ( 2018-01-13 )
* Add configuration setting for both imperial and metric temperatures. Defaults
to metric unless locale is `en_us`.
* Store units in each new post in case the setting is switched
* Minor bug fixes
* Check for existence of property before trying to display it
#### 3.3.0 ( 2018-01-11 )
* Introduce Weather Icons, licensed under SIL OFL 1.1
* Add support for weather providers
* Initial display for temperature
* Add user profile settings for location
* Add setting to set if user location is updated when a new post with location
is published by that user
* Add weather widget that can be set based on coordinates, user last reported location,
or station ID
* Allow filtering post admin and comment admin by location
* Add last seen widget
#### 3.2.4 ( 2017-12-09 )
* Fix issue with rendering of timezone select when manual offset
* Disable timezone override for now when manual offset is used as not a valid timezone
string
* Add p-location and change markup to accommodate
* Update location icon
* Add settings page and move settings out of media
#### 3.2.3
* Restore PHP 5.3 and 5.4 compatibility
* Fix issues raised by automated testing
* If you click the clock next to the word timezone it will set the timezone based
on browser time
#### 3.2.2
* Allow setting timezone from Micropub posts(requires update to Micropub plugin)
#### 3.2.1
* Show settings for current default map provider only
* Add style settings for each map provider ( props @miklb )
#### 3.2.0
* Allow passing of coordinates directly in constructor for map provider
* Switch to argument array instead of individual properties for most display and
data functions
* Support per post zoom settings
* Set initial map zoom based on geolocation accuracy
* Quick and dirty Bing Maps support
* Set location metadata for attachments if in EXIF data
* Add location metabox to attachments
* Add arguments for marking up location
* Add GEORSS support from defunct project
#### 3.1.0
* New release with more functionality coming soon
* `get_geodata` function now supports WP_Post, WP_Comment, and WP_Term objects
* Fix registration of default settings
* Add global setting for public or private by default
* Switch from admin ajax to REST Route API for simple endpoints
* Add map endpoint to retrieve a URL for a map based on coordinates
* Add reverse endpoint to retrieve an address object based on coordinates
* Allow arguments to be passed to map provider
* Remove popup location metabox and replace with slidedown metabox
* Combine geolocation and reverse lookup buttons
* Set public/private to system default if post is published outside of Post UI
#### 3.0.4
* Fix Activation Issue
#### 3.0.3
* Add support for queries and permalinks to show location enabled posts
* Use built-in WP timezone list generation code
* Fix error with private setting
* Put in check for improperly timezone setting to avoid exception error
#### 3.0.2
* Continuing to iterate based on initial feedback to 3.0.0
* Timezone box now hidden until checked
* Timezone now stored in geo_timezone in interest of consistency
* Icon Size for some fixed
* Priority of location and map box increased
* Text added to Location box to explain how to complete
* Constant SLOC_PUBLIC and filter geo_public_default allow the default to be changed
from public(1) to private(0) if no geo_public is set
* Display Address generation tweaks
* …
## Community plugin
This plugin is developed and supported by a community.
## Meta
* Version **5.0.24**
* Last updated **2 months ago**
* Active installations **300+**
* WordPress version ** 6.2 or higher **
* Tested up to **6.8.5**
* PHP version ** 7.4 or higher **
* Language
* [English (US)](https://wordpress.org/plugins/simple-location/)
* Tags
* [geo](https://pap-aw.wordpress.org/plugins/tags/geo/)[geolocation](https://pap-aw.wordpress.org/plugins/tags/geolocation/)
[location](https://pap-aw.wordpress.org/plugins/tags/location/)[maps](https://pap-aw.wordpress.org/plugins/tags/maps/)
[timezones](https://pap-aw.wordpress.org/plugins/tags/timezones/)
* [Advanced View](https://pap-aw.wordpress.org/plugins/simple-location/advanced/)
## Ratings
4.6 out of 5 stars.
* [ 7 5-star reviews ](https://wordpress.org/support/plugin/simple-location/reviews/?filter=5)
* [ 0 4-star reviews ](https://wordpress.org/support/plugin/simple-location/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/simple-location/reviews/?filter=3)
* [ 1 2-star review ](https://wordpress.org/support/plugin/simple-location/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/simple-location/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/simple-location/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/simple-location/reviews/)
## Contributors
* [ David Shanske ](https://profiles.wordpress.org/dshanske/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/simple-location/)