Simple Location

API Keys are required to use certain services. * Google * Mapbox – To retrieve style list inside the UI, you need a token with the styles:list scope * OpenWeatherMap * MapQuest * HERE * Compass * Weatherstack * Weatherbit * GeoNames – requires a username * LocationIQ * Met Office UK * OpenRoute Service * GeoApify * Visual Crossing * Meteostat * Pirate Weather * TomTom * AerisWeather – Individuals who share their personal weather station data with PWSWeather.com are offered a free contributor account.

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.

How do I add support for location to a custom post type?

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.

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.

These settings appear under Map Settings when your map provider allows storing its maps: * Serve Maps From This Site: on by default. Turn it off to load maps from the provider, with the API key in the image link. * Refresh Stored Maps After (Days): 30 by default. After this many days, the next page that shows a map fetches it again and replaces the stored image in place. Pages cached with the old image keep working. If the provider can’t be reached, the stored image is still shown. 0 never fetches stored maps again. A provider whose terms limit how long maps may be stored is refreshed at least that often. * Clear Stored Maps: deletes every stored map image. Stored maps are otherwise never deleted, including maps of locations you later changed or made private. Pages kept by a page cache may show broken images until their cache expires.

The other self-serve option is to self-host a caching static map API endpoint (see the custom map provider below).

For most map providers, the map image is loaded directly from the provider, so the API key is part of the image link and anyone viewing the page can read it. The same key is often used for geocoding, elevation, venues or weather, which your server requests itself.

Don’t restrict your main key to your site’s domain. Requests your server makes don’t come from a web page, so a domain restriction would block geocoding and the other lookups.

HERE: HERE restricts keys by app, not by key, so create a second app for maps: * In the HERE platform, open Access Manager, create a new app, and create an API key for it. Enter that key as the HERE Map API Key. * Open the new app’s Trusted domains tab, turn on “Enable Trusted domains”, and enter your site’s domain without a path, for example example.com . Changes can take up to 30 minutes to take effect. * Leave trusted domains off for the app that holds your main HERE key, which your server uses for geocoding and weather. * Maps may not load where no referring page is sent, such as some feed readers and email.

What is the custom map provider?

The server fetches every tile a map covers, so its work grows with the image size. The plugin asks it for maps no larger than 1280 by 1280 pixels, shrinking larger maps to fit. To change this, define SLOC_STATICMAP_MAX_WIDTH and SLOC_STATICMAP_MAX_HEIGHT in wp-config.php, or use the sloc_staticmap_max_size filter.

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.

Currently, only Visual Crossing supports historic weather data on their basic plan. Meteostat consists solely of historical data and has no current data.

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.

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.

The Location Icon does not retrieve my location.

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.

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.

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

C