WW1 France & Flanders Public API

No Daily Limits - Free - Simple to Use!

• This API returns a latitude, longitude from a well-formed British Trench Map reference.
• We require &term= to be followed by all of: - sheet name, letter, number, grid, x ordinate & y ordinate.
• You must input the full term. &term=62d.J.19.b will error as it is missing the x and y ordinate.
• Each component must be separated by a period (dot or full stop).
• We only support sheets 11, 12, 13, 14, 15, 19, 20, 21, 22, 23, 27, 28, 29, 30, 31, 36a, 36, 37, 38, 39, 36b, 36c, 44, 45, 46, 51c, 51b, 51a, 51, 52, 57d, 57c, 57b, 57a, 57, 62d, 62c, 62b, 62a, 62, 66e, 66d, 66c, 66b & 66a.
• This API uses verbose errors so you should receive a full explanation for each error.

• This API returns a list of WW1 localities that match the term you supply.
• Internally the search is performed as an SQL WHERE term LIKE '%Minden Post%'. API input &term=ear will return year, pear, pearl etc.
• Search is case-insensitive.
• Search ignores accents, diacritical marks etc. pozieres will retrieve Pozières and moy finds Moÿ-de-l'Aisne.
• Searching on Passchendaele also returns Passendale & vice-versa.
• A successful result is a JSON Encoded object consisting of the id, term, tmref, sheet, letter, quadrant, comment, tag, type, latitude, longitude, bound.
• This is our database id, full name, trench map reference, map sheet, letter, quadrant, additional details, tag, geonames type, latitude, longitude, locality precision.
• A maximum of 30 records will be returned.
• This API is terse and any errors result in a 400 or 404 HTTP response.

• This simple API returns a list of WW1 localities within a radius of a given location.
• If the radius is not supplied it is set to 5,000 metres.
• If the radius is too low it is set to 250 metres.
• If the radius is too high it is set to 25,000 metres.
• A successful result is a JSON Encoded object consisting of the geonames id, term, tmref, tag, type, latitude, longitude, bound. See API #2.
• It is sorted by distance, then type (eg farm, school etc).
• A maximum of 128 records will be returned.
• This API is terse and any errors result in a 400 or 404 HTTP response.

• This simple API returns a list of modern localities within a radius of a given location.
• Recent population values and modern satellite elevation are included.
• See API #2 and #3 for radius and returned data.
• &type=p sorts results by population (default) descending, &type=e by elevation.
• The date of the last population census for each locality is also returned.
• A maximum of 128 records will be returned.
• This API is terse and any errors result in a 400 or 404 HTTP response.

• This API returns localities within a map sheet with recent population values.
• Data returned is sorted by descending population, then quadrant.
• &quadrant=NW can be set to a 16,000 x 10,000 metre quadrant. Values are NW, NE, SW, SE.
• For extra granularity, any quadrant can be subdivided into 8,000 x 5,000 m. sub quadrants such as &quadrant=NW3. Values are the quadrant itself and a number from 1 - 4.
• &min=1 can be set from 0 to 999 and filters out any populated centre below the minimum value. The default is 1.
• &limit=25 can be set from 1 to 128 and determines the maximum number returned. The default is 128.
• See API #2 for returned data. Additionally, the quadrant is returned.
• This API is terse and any errors result in a 400 or 404 HTTP response.

• This simple API returns a list of Victoria Cross recipients within a radius of a given location.
• This API covers recipients world-wide.
• Data returned is id, recipient, unit, date, location, outcome - died or survived, direct link to Wikipedia entry, Wikipedia Unit article.
• Distance is not displayed - the source data is a general guide to the unit location, not to the action itself.
• Data is sorted by locality, then recipient.
• A maximum of 128 records are returned.
• See API #2 for radius options.
• This API is terse and any errors result in a 400 or 404 HTTP response.

• This simple API returns a list of cemeteries and memorials within a radius of a given location.
• Data returned is id, distance (in metres), name, region & country, type (eg Military Cemetery Extension), number of WW1 casualties, latitude, longitude, CWGC website (exact link for cemtery with WW1 casualties).
• Data is sorted by distance, then country.
• A maximum of 128 records are returned.
• See API #2 for radius options.
• This API is terse and any errors result in a 400 or 404 HTTP response.

Sub-Notes

1. The lat, lon & distance are to the nearest public entrance. These are souced from driving directions Point of Interest data. In many cases this is the same as the main cemetery entrance. In a small number, there is a cemetery and separate cemetery extension off the main road. Buttes New British Cemetery, Polygon Wood is just in from the main road and has 3 separate cemeteries. We show the same lat, lon so the individul CWGC website coordinates will differ marginally from ours.
2. We return the total number of WW1 casualties. The direct link to the CWGC website will display the number of identified casualties.

• This simple API returns a list of Military Engagements near to a given location.
• Distance is not displayed - the source data is a general guide to a very large & sometimes fluid geographical area.
• We recommend an initial radius of 10,000 metres and increment in 5 km steps to return meaningful information.
• We return the name, a direct link to the Wikipedia entry, latitude, longitude.
• This API is terse and any errors result in a 400 or 404 HTTP response.

• This simple API returns the lat, lon for the NW, NE, SE & SW vertices (corners) given a map sheet & quadrant.
• The current version only returns data for — eg NW1, NW2, NW3, NW4.
• The option dms=1 converts decimal degrees into degree, minute, second — 50° 29' 57.9".
• This API is terse and any errors result in a 400 or 404 HTTP response.