Including geo coordinates
In order to maximise the usefulness of your data, it is highly recommended that it includes
GeoCoordinates. Many data users will not use your data unless it includes a
geoproperty of each
"name": "Middlesbrough Sports Village",
"description": "You can enjoy a huge range of different sports and activities at Middlesbrough Sports Village. There’s a state-of-the-art gym, a full programme of group exercise classes, indoor badminton sessions and a soft play area for kids. Outside, the Village boasts a full range of athletics facilities, including an eight-lane 400m track, a 10-lane 100m track, as well as four long jump pits. There’s also high jump, hammer throwing, javelin and pole vaulting facilities. The latest addition to the facility is a £1.6m, 250m velodrome, alongside five all-weather outdoor pitches and a skate park for BMX bikes, scooters and inline skaters.",
"telephone": "01642 728555",
"streetAddress": "Alan Peacock Way",
"addressLocality": "Village East",
"postalCode": "TS4 3AE",
In order to publish geographic coordinates in your open data feed, you must ensure that the source of these coordinates (usually your geocoder) permits you to republish this data under an open licence.
The basic Google Geocoding API licence does not permit open data republishing, and does not permit including the data in any externally facing API.
Given the inaccuracy of geocoding for sports venues, we recommend using leaflet.js (or a similar service) to implement a map to allow your users to move a pin to a specific location.
Below is a copy-and-pastable example of a drag-and-drop map pin and geocoder, that can be used within your booking system to allow the user to enter reliable latitude and longitude data.
On load you may specify the
map.centerMap(lat, lng)to set the initial position of the map.
On pressing the geocode button, the geocoder provides both
longitude, which can then be stored in your database and later used within your open data feed(s). The map pin can also be used to adjust these values.
See the "Result" tab below for a live demo.
An example of the map pin interface within the Gladstone leisure management system is shown below.
Screenshot of the drag-and-drop map pin within the Gladstone system
Last modified 3yr ago