Publishing Data
Using data
Open Booking API
Specifications
Including geo coordinates
Using geographic 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 latitude and longitude within the geo property of each Place.1
"location": {
2
"@type": "Place",
3
"url": "https://www.everyoneactive.com/centres/Middlesbrough-Sports-Village",
4
"name": "Middlesbrough Sports Village",
5
"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.",
6
"telephone": "01642 728555",
7
"address": {
8
"@type": "PostalAddress",
9
"streetAddress": "Alan Peacock Way",
10
"addressLocality": "Village East",
11
"addressRegion": "Middlesbrough",
12
"postalCode": "TS4 3AE",
13
"addressCountry": "GB"
14
},
15
"geo": {
16
"@type": "GeoCoordinates",
17
"latitude": 54.543964,
18
"longitude": -1.20978500000001
19
}
20
}
Copied!
Licensing and republishing
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.
Rendering a geocoding user interface
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.
Leaflet.js and OpenCage implementation example
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
latitude and 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.
Gladstone: Implementation example
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 1yr ago