osm reverse geocoding

osm_reverse_geocoding.php

<?php
/**
 * osm reverse geocoding
 * https://nominatim.openstreetmap.org/reverse?format=jsonv2&lat=52.5487429714954&lon=-1.81602098644987&zoom=18&addressdetails=1
 * 
 * @param string|float $lat
 * @param string|float $long
 * @return array
 * @throws Exception    
 * @see https://wiki.openstreetmap.org/wiki/Nominatim
 * @see https://nominatim.org/release-docs/develop/api/Reverse/
 * @author sumonst21
 */
function osm_reverse_geocoding($lat, $long)
{
	$lat = trim($lat);
	$long = trim($long);
	$email = '';
	$params = array(
		'format' => 'jsonv2',
		'addressdetails' => 1,
		'email' => $email,
		'lat' => $lat,
		'lon' => $long,
		'limit' => 1,
		'accept-language' => 'de,en',
		'dedupe' => 1,
	);
	$url = "https://nominatim.openstreetmap.org/reverse?" . http_build_query($params);
	$res = _curl($url);
	if (empty($res)) {
		throw new Exception(Yii::t("default", "reverse geocoding failed"));
	}
	$data = json_decode($res, true);
	if (empty($data) || !is_array($data) || count($data) == 0) {
		throw new Exception(Yii::t("default", "reverse geocoding failed"));
	}
	return $data;
}