Version 4.7.6

system/GeoLocation/GeoCoder/Mapbox.php

@@ -22,6 +22,82 @@ if ( !\defined( '\IPS\SUITE_UNIQUE_KEY' ) )
  */
 class _Mapbox extends \IPS\GeoLocation\GeoCoder
 {
+	/**
+	 * Get by location string
+	 *
+	 * @param string $location
+	 * @return \IPS\GeoLocation
+	 * @throws \BadFunctionCallException
+	 */
+	public static function decodeLocation( string $location )
+	{
+		if ( \IPS\Settings::i()->mapbox AND \IPS\Settings::i()->mapbox_api_key )
+		{
+			$data = \IPS\Http\Url::external( "https://api.mapbox.com/geocoding/v5/mapbox.places/{$location}.json" )->setQueryString( array(
+				'access_token'		=> \IPS\Settings::i()->mapbox_api_key,
+			) )->request()->get()->decodeJson();
+
+			$obj = new \IPS\GeoLocation;
+
+			$_address	= '';
+
+			/* Make sure the response from Mapbox is valid */
+			if( isset( $data['results'] ) AND \is_array( $data['results'] ) AND \count( $data['results'] ) )
+			{
+				if( isset( $data['results'][0]['geometry'] ) AND isset( $data['results'][0]['geometry']['coordinates'] ) )
+				{
+					$obj->long = $data['results'][0]['geometry']['coordinates'][0];
+					$obj->lat = $data['results'][0]['geometry']['coordinates'][1];
+				}
+
+				$obj->placeName = $data['results'][0]['place_name'];
+
+				foreach( $data['results'][0]['address_components'] as $component )
+				{
+					if( $component['types'][0] == 'street_number' )
+					{
+						$_address	= $component['long_name'];
+					}
+					elseif( $component['types'][0] == 'route' )
+					{
+						$_address	.= " " . $component['long_name'];
+					}
+
+					if( $component['types'][0] == 'postal_code' )
+					{
+						$obj->postalCode	= $component['long_name'];
+					}
+
+					if( $component['types'][0] == 'country' )
+					{
+						$obj->country	= $component['short_name'];
+					}
+
+					if( $component['types'][0] == 'administrative_area_level_1' )
+					{
+						$obj->region	= $component['long_name'];
+					}
+
+					if( $component['types'][0] == 'locality' )
+					{
+						$obj->city	= $component['long_name'];
+					}
+				}
+			}
+
+			if( $_address )
+			{
+				$obj->addressLines	= array( $_address );
+			}
+
+			return $obj;
+		}
+		else
+		{
+			throw new \BadFunctionCallException;
+		}
+	}
+
 	/**
 	 * Get by latitude and longitude
 	 *