Get geographical information

This endpoint returns information about a given location.

Request

Path Parameters
Query Parameters	Value
`lat`	The latitude of the location you want to know more about.
`lon`	The longitude of the location you want to know more about.

Examples

Example Request

GET /v1/geo/51.178889/-1.826111 HTTP/1.1
Host: api.thefifthworld.com

Response

If you don’t provide a latitude and longitude, the API responds with a 500 HTTP response. If you do provide both a latitude and a longitude, the endpoint responds with a 200 HTTP status and a JSON object providing information about the location.

Location Information Object
Property	Value Type	Value
`coords`	`[number]`	This array provides back the coordinates given, with the latitude first and the longitude second.
`isOcean`	`boolean`	In the Fifth World, the ice caps have melted, resulting in 65 meters (or approximately 216 feet) of sea level rise. If the given location lies in the ocean (even if it lies on dry land today), this property will equal `true`.
`isCoastal`	`boolean`	In the Fifth World, the ice caps have melted, resulting in 65 meters (or approximately 216 feet) of sea level rise. If the given location lies within 10 miles of the ocean (even if it doesn’t today), this property will equal `true`.
`nearbyCommunities`	`[object]`	This property provides an array of objects listing the communities that lay claim to places within 40 kilometers (just under 25 miles) of the given location. Each object has two properties, both strings: `name` (which provides the name of the community) and `path` (which provides the community’s unique path on the wiki).
`hemisphere`	`string`	This property will equal `N` if your location lies within the northern hemisphere, or `S` if it lies within the southern hemisphere.
`cell`	`string`	This property will name the atmospheric circulation cell that your location lies within: either `Polar`, `Ferrel`, or `Hadley`.
`pressure`	`string`	This property indicates if your location lies within an area of generally high barometric pressure, where air generally rises (`H`), or an area of generally low barometric pressure, where air generally descends (`L`).
`winds`	`string`	This property indicates the prevailing winds in your location — westerly (`W`) or easterly (`E`).

Example

Example Response

{
  coords: [ 51.178889, -1.826111 ],
  isOcean: false,
  isCoastal: true,
  nearbyCommunities: [],
  hemisphere: 'N',
  cell: 'Ferrel',
  pressure: 'L',
  winds: 'W'
}