Returns the nearest named location for a given GPS coordinates.

//native

/**

 * Returns the nearest named location for a given GPS coordinates.

 * ## Search for nearest place by coordinates

You can use this endpoint to find the nearest place from given coordinates.

*Note: If you specify coordinates of a secluded place (e.g. middle of the ocean), the nearest point can be very far from the coordinates.*

 */

export async function main(

	auth: RT.Meteosource,

	lat: string | undefined,

	lon: string | undefined,

	language?: 'cs' | 'en' | 'de' | 'es' | 'fr' | 'pl' | 'pt' | undefined,

	key?: string | undefined

) {

	const url = new URL(`https://www.meteosource.com/api/v1/${auth.tier}/nearest_place`)

	for (const [k, v] of [

		['lat', lat],

		['lon', lon],

		['language', language],

		['key', key]

	]) {

		if (v !== undefined && v !== '') {

			url.searchParams.append(k, v)

		}

	}

	const response = await fetch(url, {

		method: 'GET',

		headers: {

			'X-API-Key': auth.apiKey

		},

		body: undefined

	})

	if (!response.ok) {

		const text = await response.text()

		throw new Error(`${response.status} ${text}`)

	}

	return await response.json()

}