biscolab / google-maps-php-sdk

src/Object/Address.php

Indentation +9 added lines, -9 removed lines

@@ -21,14 +21,14 @@
 class Address extends AbstractCollection
 {
 
-	/**
-	 * @param $item
-	 *
-	 * @return AddressComponent
-	 */
-	protected function parseItem($item)
-	{
+    /**
+     * @param $item
+     *
+     * @return AddressComponent
+     */
+    protected function parseItem($item)
+    {
 
-		return ($item instanceof AddressComponent) ? $item : new AddressComponent($item);
-	}
+        return ($item instanceof AddressComponent) ? $item : new AddressComponent($item);
+    }
 }
\ No newline at end of file

src/Object/Photo.php

Indentation +29 added lines, -29 removed lines

@@ -16,33 +16,33 @@
 class Photo extends AbstractObject
 {
 
-	/**
-	 * @var null|int
-	 */
-	protected $height = null;
-
-	/**
-	 * @var null|int
-	 */
-	protected $width = null;
-
-	/**
-	 * @var null|string
-	 */
-	protected $photo_reference = null;
-
-	/**
-	 * @var null|string
-	 */
-	protected $html_attributions = null;
-
-	/**
-	 * @var array
-	 */
-	protected $typeCheck = [
-		PhotoFields::HEIGHT            => 'int',
-		PhotoFields::WIDTH             => 'int',
-		PhotoFields::PHOTO_REFERENCE   => 'string',
-		PhotoFields::HTML_ATTRIBUTIONS => 'array',
-	];
+    /**
+     * @var null|int
+     */
+    protected $height = null;
+
+    /**
+     * @var null|int
+     */
+    protected $width = null;
+
+    /**
+     * @var null|string
+     */
+    protected $photo_reference = null;
+
+    /**
+     * @var null|string
+     */
+    protected $html_attributions = null;
+
+    /**
+     * @var array
+     */
+    protected $typeCheck = [
+        PhotoFields::HEIGHT            => 'int',
+        PhotoFields::WIDTH             => 'int',
+        PhotoFields::PHOTO_REFERENCE   => 'string',
+        PhotoFields::HTML_ATTRIBUTIONS => 'array',
+    ];
 }
\ No newline at end of file

src/Object/AddressComponent.php

Indentation +20 added lines, -20 removed lines

@@ -26,27 +26,27 @@
 class AddressComponent extends AbstractObject
 {
 
-	/**
-	 * @var string
-	 */
-	protected $long_name = null;
+    /**
+     * @var string
+     */
+    protected $long_name = null;
 
-	/**
-	 * @var string
-	 */
-	protected $short_name = null;
+    /**
+     * @var string
+     */
+    protected $short_name = null;
 
-	/**
-	 * @var array
-	 */
-	protected $types = null;
+    /**
+     * @var array
+     */
+    protected $types = null;
 
-	/**
-	 * @var array
-	 */
-	protected $typeCheck = [
-		AddressComponentFields::LONG_NAME  => 'string',
-		AddressComponentFields::SHORT_NAME => 'string',
-		AddressComponentFields::TYPES      => 'array'
-	];
+    /**
+     * @var array
+     */
+    protected $typeCheck = [
+        AddressComponentFields::LONG_NAME  => 'string',
+        AddressComponentFields::SHORT_NAME => 'string',
+        AddressComponentFields::TYPES      => 'array'
+    ];
 }
\ No newline at end of file

src/Utils/Config.php

Indentation +4 added lines, -4 removed lines

@@ -17,8 +17,8 @@
  */
 class Config
 {
-	/**
-	 * @var int
-	 */
-	const  MAX_PLACE_RADIUS_VALUE = 50000;
+    /**
+     * @var int
+     */
+    const  MAX_PLACE_RADIUS_VALUE = 50000;
 }
\ No newline at end of file

src/Abstracts/Api.php

Indentation +176 added lines, -176 removed lines

@@ -25,182 +25,182 @@
 abstract class Api
 {
 
-	/**
-	 * @var string
-	 */
-	const SERVICE_ENDPOINT = null;
-
-	/**
-	 * @var GoogleMapsApi
-	 */
-	protected $google_maps_api = null;
-
-	/**
-	 * @var string
-	 */
-	protected $result_type = '';
-
-	/**
-	 * @var string
-	 */
-	protected $result_collection_type = '';
-
-	/**
-	 * @var GoogleMapsResponse
-	 */
-	protected $response;
-
-	/**
-	 * @var GoogleMapsRequest
-	 */
-	protected $request;
-
-	/**
-	 * Api constructor.
-	 *
-	 * @param array $config
-	 */
-	public function __construct(array $config = [])
-	{
-
-		$service_config = $this->getServiceConfig($config);
-		$this->setGoogleMapsApi(new GoogleMapsApi($service_config));
-	}
-
-	/**
-	 * @param array $config
-	 *
-	 * @return array
-	 */
-	protected function getServiceConfig(array $config = []): array
-	{
-
-		return array_merge($config, [
-			GoogleMapsApiConfigFields::SERVICE_ENDPOINT => $this->getServiceEndpoint()
-		]);
-	}
-
-	/**
-	 * @return string
-	 */
-	public function getServiceEndpoint(): string
-	{
-
-		return static::SERVICE_ENDPOINT ?? '';
-	}
-
-	/**
-	 * @param array       $params
-	 * @param null|string $endpoint
-	 *
-	 * @return GoogleMapsResult|GoogleMapsResultsCollection
-	 */
-	public function callApi(array $params, ?string $endpoint = null)
-	{
-
-		$this->createRequest($params, $endpoint);
-
-		return $this->getResponseResult();
-	}
-
-	/**
-	 * @param array       $params
-	 * @param null|string $endpoint since 0.5.0
-	 *
-	 * @return GoogleMapsRequest
-	 */
-	public function createRequest(array $params, ?string $endpoint = null): GoogleMapsRequest
-	{
-
-		$this->request = new GoogleMapsRequest($params, $endpoint);;
-
-		return $this->request;
-	}
-
-	/**
-	 * @return GoogleMapsResult|GoogleMapsResultsCollection
-	 */
-	public function getResponseResult()
-	{
-
-		$result = $this->getResponse()->getResult();
-		if ($result) {
-			$result_type = $this->result_type;
-
-			return new $result_type($result);
-		}
-		$results = $this->getResponse()->getResults();
-
-		$result_collection_type_class = $this->result_collection_type;
-
-		return new $result_collection_type_class($results);
-	}
-
-	/**
-	 * @return GoogleMapsResponse
-	 */
-	public function getResponse(): GoogleMapsResponse
-	{
-
-		$this->response = $this->getGoogleMapsApi()->get($this->request);
-
-		return $this->response;
-	}
-
-	/**
-	 * @return GoogleMapsApi
-	 */
-	public function getGoogleMapsApi(): GoogleMapsApi
-	{
-
-		return $this->google_maps_api;
-	}
-
-	/**
-	 * @param GoogleMapsApi $google_maps_api
-	 *
-	 * @return Api
-	 */
-	public function setGoogleMapsApi(GoogleMapsApi $google_maps_api): Api
-	{
-
-		$this->google_maps_api = $google_maps_api;
-
-		return $this;
-	}
-
-	/**
-	 * @return GoogleMapsResultsCollection
-	 */
-	public function getSingleResult(): GoogleMapsResultsCollection
-	{
-
-		$results = $this->getResponse()->getResults();
-
-		$result_collection_type_class = $this->result_collection_type;
-
-		return new $result_collection_type_class($results);
-	}
-
-	/**
-	 * @return GoogleMapsResultsCollection
-	 */
-	public function getNextPage(): GoogleMapsResultsCollection
-	{
-
-		if ($this->responseHasNewPage()) {
-			$this->request->setParam(GoogleMapsRequestFields::NEXT_PAGE_TOKEN, $this->response->getNextPageToken());
-		}
-
-		return $this->getResponseResult();
-	}
+    /**
+     * @var string
+     */
+    const SERVICE_ENDPOINT = null;
+
+    /**
+     * @var GoogleMapsApi
+     */
+    protected $google_maps_api = null;
+
+    /**
+     * @var string
+     */
+    protected $result_type = '';
+
+    /**
+     * @var string
+     */
+    protected $result_collection_type = '';
+
+    /**
+     * @var GoogleMapsResponse
+     */
+    protected $response;
+
+    /**
+     * @var GoogleMapsRequest
+     */
+    protected $request;
+
+    /**
+     * Api constructor.
+     *
+     * @param array $config
+     */
+    public function __construct(array $config = [])
+    {
+
+        $service_config = $this->getServiceConfig($config);
+        $this->setGoogleMapsApi(new GoogleMapsApi($service_config));
+    }
+
+    /**
+     * @param array $config
+     *
+     * @return array
+     */
+    protected function getServiceConfig(array $config = []): array
+    {
+
+        return array_merge($config, [
+            GoogleMapsApiConfigFields::SERVICE_ENDPOINT => $this->getServiceEndpoint()
+        ]);
+    }
+
+    /**
+     * @return string
+     */
+    public function getServiceEndpoint(): string
+    {
+
+        return static::SERVICE_ENDPOINT ?? '';
+    }
+
+    /**
+     * @param array       $params
+     * @param null|string $endpoint
+     *
+     * @return GoogleMapsResult|GoogleMapsResultsCollection
+     */
+    public function callApi(array $params, ?string $endpoint = null)
+    {
+
+        $this->createRequest($params, $endpoint);
+
+        return $this->getResponseResult();
+    }
+
+    /**
+     * @param array       $params
+     * @param null|string $endpoint since 0.5.0
+     *
+     * @return GoogleMapsRequest
+     */
+    public function createRequest(array $params, ?string $endpoint = null): GoogleMapsRequest
+    {
+
+        $this->request = new GoogleMapsRequest($params, $endpoint);;
+
+        return $this->request;
+    }
+
+    /**
+     * @return GoogleMapsResult|GoogleMapsResultsCollection
+     */
+    public function getResponseResult()
+    {
+
+        $result = $this->getResponse()->getResult();
+        if ($result) {
+            $result_type = $this->result_type;
+
+            return new $result_type($result);
+        }
+        $results = $this->getResponse()->getResults();
+
+        $result_collection_type_class = $this->result_collection_type;
+
+        return new $result_collection_type_class($results);
+    }
+
+    /**
+     * @return GoogleMapsResponse
+     */
+    public function getResponse(): GoogleMapsResponse
+    {
+
+        $this->response = $this->getGoogleMapsApi()->get($this->request);
+
+        return $this->response;
+    }
+
+    /**
+     * @return GoogleMapsApi
+     */
+    public function getGoogleMapsApi(): GoogleMapsApi
+    {
+
+        return $this->google_maps_api;
+    }
+
+    /**
+     * @param GoogleMapsApi $google_maps_api
+     *
+     * @return Api
+     */
+    public function setGoogleMapsApi(GoogleMapsApi $google_maps_api): Api
+    {
+
+        $this->google_maps_api = $google_maps_api;
+
+        return $this;
+    }
+
+    /**
+     * @return GoogleMapsResultsCollection
+     */
+    public function getSingleResult(): GoogleMapsResultsCollection
+    {
+
+        $results = $this->getResponse()->getResults();
+
+        $result_collection_type_class = $this->result_collection_type;
+
+        return new $result_collection_type_class($results);
+    }
+
+    /**
+     * @return GoogleMapsResultsCollection
+     */
+    public function getNextPage(): GoogleMapsResultsCollection
+    {
+
+        if ($this->responseHasNewPage()) {
+            $this->request->setParam(GoogleMapsRequestFields::NEXT_PAGE_TOKEN, $this->response->getNextPageToken());
+        }
+
+        return $this->getResponseResult();
+    }
 
-	/**
-	 * @return bool
-	 */
-	public function responseHasNewPage(): bool
-	{
+    /**
+     * @return bool
+     */
+    public function responseHasNewPage(): bool
+    {
 
-		return ($this->response instanceof GoogleMapsResponse) ? $this->response->getNextPageToken() : false;
-	}
+        return ($this->response instanceof GoogleMapsResponse) ? $this->response->getNextPageToken() : false;
+    }
 }
\ No newline at end of file

src/Object/Review.php

Indentation +33 added lines, -33 removed lines

@@ -21,37 +21,37 @@
 class Review extends AbstractObject
 {
 
-	/**
-	 * @var null|int
-	 */
-	protected $height = null;
-
-	/**
-	 * @var null|int
-	 */
-	protected $width = null;
-
-	/**
-	 * @var null|string
-	 */
-	protected $photo_reference = null;
-
-	/**
-	 * @var null|string
-	 */
-	protected $html_attributions = null;
-
-	/**
-	 * @var array
-	 */
-	protected $typeCheck = [
-		ReviewFields::AUTHOR_NAME               => 'string',
-		ReviewFields::AUTHOR_URL                => 'string',
-		ReviewFields::LANGUAGE                  => 'string',
-		ReviewFields::PROFILE_PHOTO_URL         => 'string',
-		ReviewFields::RATING                    => 'int',
-		ReviewFields::RELATIVE_TIME_DESCRIPTION => 'string',
-		ReviewFields::TEXT                      => 'string',
-		ReviewFields::TIME                      => 'int',
-	];
+    /**
+     * @var null|int
+     */
+    protected $height = null;
+
+    /**
+     * @var null|int
+     */
+    protected $width = null;
+
+    /**
+     * @var null|string
+     */
+    protected $photo_reference = null;
+
+    /**
+     * @var null|string
+     */
+    protected $html_attributions = null;
+
+    /**
+     * @var array
+     */
+    protected $typeCheck = [
+        ReviewFields::AUTHOR_NAME               => 'string',
+        ReviewFields::AUTHOR_URL                => 'string',
+        ReviewFields::LANGUAGE                  => 'string',
+        ReviewFields::PROFILE_PHOTO_URL         => 'string',
+        ReviewFields::RATING                    => 'int',
+        ReviewFields::RELATIVE_TIME_DESCRIPTION => 'string',
+        ReviewFields::TEXT                      => 'string',
+        ReviewFields::TIME                      => 'int',
+    ];
 }
\ No newline at end of file

src/Object/ReviewCollection.php

Indentation +13 added lines, -13 removed lines

@@ -20,19 +20,19 @@
 class ReviewCollection extends AbstractCollection
 {
 
-	/**
-	 * @var string
-	 */
-	protected $item_class = Review::class;
+    /**
+     * @var string
+     */
+    protected $item_class = Review::class;
 
-	/**
-	 * @param $item
-	 *
-	 * @return Review
-	 */
-	protected function parseItem($item): Review
-	{
+    /**
+     * @param $item
+     *
+     * @return Review
+     */
+    protected function parseItem($item): Review
+    {
 
-		return ($item instanceof $this->item_class) ? $item : new $this->item_class($item);
-	}
+        return ($item instanceof $this->item_class) ? $item : new $this->item_class($item);
+    }
 }
\ No newline at end of file

src/Api/Elevation.php

Indentation +87 added lines, -87 removed lines

@@ -28,92 +28,92 @@
 class Elevation extends Api
 {
 
-	/**
-	 * @var string
-	 */
-	const SERVICE_ENDPOINT = 'elevation';
-
-	/**
-	 * @var string
-	 */
-	protected $result_collection_type = ElevationResultsCollection::class;
-
-	/**
-	 * Positional Requests
-	 *
-	 * @param LatLng|string|array $locations
-	 * This parameter takes either a single location or multiple locations passed as an array or as an encoded polyline
-	 *
-	 * @return GoogleMapsResultsCollection
-	 *
-	 * @since 0.3.0
-	 */
-	public function getByLocations($locations): GoogleMapsResultsCollection
-	{
-
-		$locations = $this->parseLocations($locations);
-
-		return $this->callApi([
-			GoogleMapsRequestFields::LOCATIONS => $locations
-		]);
-	}
-
-	/**
-	 * @param array|string $locations
-	 *
-	 * @return string
-	 *
-	 * @since   0.3.0
-	 */
-	public function parseLocations($locations): string
-	{
-
-		if ($locations instanceof Path) {
-			$locations = $locations->toArray();
-		}
-
-		if (is_array($locations)) {
-			$locations = implode('|', array_map(function ($item) {
-
-				return (string)$item;
-			}, $locations));
-		}
-
-		return (string)$locations;
-	}
-
-	/**
-	 * Sampled Path Requests
-	 *
-	 * @param array|string $path
-	 * This parameter takes either a multiple locations passed as an array or as an encoded polyline
-	 *
-	 * @param int          $samples
-	 * This will be the number of results as well
-	 *
-	 * @throws InvalidArgumentException
-	 * @return GoogleMapsResultsCollection
-	 *
-	 * @since 0.4.0
-	 */
-	public function getBySampledPath($path, int $samples): GoogleMapsResultsCollection
-	{
-
-		if ((is_array($path) && count($path) < 2) ||
-			$path instanceof Path && $path->count() < 2) {
-			throw new InvalidArgumentException('The number of items provided in the path must be greater than 1 (One)');
-		}
-
-		if ($samples <= 0) {
-			throw new InvalidArgumentException('The number of samples must be greater than 0 (Zero)');
-		}
-
-		$path = $this->parseLocations($path);
-
-		return $this->callApi([
-			GoogleMapsRequestFields::PATH    => $path,
-			GoogleMapsRequestFields::SAMPLES => $samples,
-		]);
-	}
+    /**
+     * @var string
+     */
+    const SERVICE_ENDPOINT = 'elevation';
+
+    /**
+     * @var string
+     */
+    protected $result_collection_type = ElevationResultsCollection::class;
+
+    /**
+     * Positional Requests
+     *
+     * @param LatLng|string|array $locations
+     * This parameter takes either a single location or multiple locations passed as an array or as an encoded polyline
+     *
+     * @return GoogleMapsResultsCollection
+     *
+     * @since 0.3.0
+     */
+    public function getByLocations($locations): GoogleMapsResultsCollection
+    {
+
+        $locations = $this->parseLocations($locations);
+
+        return $this->callApi([
+            GoogleMapsRequestFields::LOCATIONS => $locations
+        ]);
+    }
+
+    /**
+     * @param array|string $locations
+     *
+     * @return string
+     *
+     * @since   0.3.0
+     */
+    public function parseLocations($locations): string
+    {
+
+        if ($locations instanceof Path) {
+            $locations = $locations->toArray();
+        }
+
+        if (is_array($locations)) {
+            $locations = implode('|', array_map(function ($item) {
+
+                return (string)$item;
+            }, $locations));
+        }
+
+        return (string)$locations;
+    }
+
+    /**
+     * Sampled Path Requests
+     *
+     * @param array|string $path
+     * This parameter takes either a multiple locations passed as an array or as an encoded polyline
+     *
+     * @param int          $samples
+     * This will be the number of results as well
+     *
+     * @throws InvalidArgumentException
+     * @return GoogleMapsResultsCollection
+     *
+     * @since 0.4.0
+     */
+    public function getBySampledPath($path, int $samples): GoogleMapsResultsCollection
+    {
+
+        if ((is_array($path) && count($path) < 2) ||
+            $path instanceof Path && $path->count() < 2) {
+            throw new InvalidArgumentException('The number of items provided in the path must be greater than 1 (One)');
+        }
+
+        if ($samples <= 0) {
+            throw new InvalidArgumentException('The number of samples must be greater than 0 (Zero)');
+        }
+
+        $path = $this->parseLocations($path);
+
+        return $this->callApi([
+            GoogleMapsRequestFields::PATH    => $path,
+            GoogleMapsRequestFields::SAMPLES => $samples,
+        ]);
+    }
 
 }
\ No newline at end of file

src/Api/Places.php

Indentation +222 added lines, -222 removed lines

@@ -34,233 +34,233 @@
 class Places extends Api
 {
 
-	/**
-	 * @var string
-	 */
-	const SERVICE_ENDPOINT = 'place';
-
-	/**
-	 * @var string
-	 */
-	protected $result_type = PlacesResult::class;
-
-	/**
-	 * @var string
-	 */
-	protected $result_collection_type = PlaceResultsCollection::class;
-
-	/**
-	 * @param string     $query
-	 * @param array|null $params
-	 * @param array|null $fields
-	 *
-	 * @return GoogleMapsResultsCollection
-	 * @see https://developers.google.com/places/web-service/search#FindPlaceRequests
-	 */
-	public function findPlaceByText(
-		string $query,
-		?array $params = [],
-		?array $fields = []
-	): GoogleMapsResultsCollection {
-
-		$params = array_merge($params, [
-			GoogleMapsRequestFields::INPUT  => $query,
-			GoogleMapsRequestFields::FIELDS => implode(',', $fields)
-		]);
-
-		return $this->findPlace($params);
-
-	}
-
-	/**
-	 * Find Places requests
-	 *
-	 * @param array $params
-	 *        GoogleMapsRequestFields::INPUT required
-	 *
-	 * @see     https://developers.google.com/places/web-service/search#FindPlaceRequests
-	 * @return GoogleMapsResultsCollection
-	 * @throws InvalidArgumentException
-	 * @since   0.5.0
-	 */
-	public function findPlace(array $params): GoogleMapsResultsCollection
-	{
-
-		// see \Biscolab\GoogleMaps\Values\PlaceInputTypeValues
-		if (empty($params[GoogleMapsRequestFields::INPUTTYPE])) {
-			$params[GoogleMapsRequestFields::INPUTTYPE] = PlaceInputTypeValues::TEXTQUERY;
-		}
-
-		if (empty($params[GoogleMapsRequestFields::INPUT])) {
-			throw new InvalidArgumentException(GoogleMapsRequestFields::INPUT . " field is required");
-		}
-
-		return $this->makeApiCall($params, PlaceServicesEndpoints::FINDPLACEFROMTEXT);
-	}
-
-	/**
-	 * @param array  $params
-	 * @param string $endpoint
-	 *
-	 * @return GoogleMapsResult|GoogleMapsResultsCollection
-	 * @since   0.5.0
-	 */
-	public function makeApiCall(array $params, string $endpoint)
-	{
-
-		return $this->callApi($params, $endpoint);
-	}
-
-	/**
-	 * @param string     $number
-	 * @param array|null $params
-	 * @param array|null $fields
-	 *
-	 * @return GoogleMapsResultsCollection
-	 */
-	public function findPlaceByPhoneNumber(
-		string $number,
-		?array $params = [],
-		?array $fields = []
-	): GoogleMapsResultsCollection {
-
-		$params = array_merge($params, [
-			GoogleMapsRequestFields::INPUT     => $number,
-			GoogleMapsRequestFields::INPUTTYPE => PlaceInputTypeValues::PHONENUMBER,
-			GoogleMapsRequestFields::FIELDS    => implode(',', $fields)
-		]);
-
-		return $this->findPlace($params);
-
-	}
-
-	/**
-	 * @param Location   $location
-	 * @param int        $radius
-	 * @param array|null $params
-	 *
-	 * @return GoogleMapsResultsCollection
-	 */
-	public function findNearbyPlaceByRadius(
-		Location $location,
-		int $radius,
-		?array $params = []
-	): GoogleMapsResultsCollection {
-
-		$params = array_merge($params, [
-			GoogleMapsRequestFields::LOCATION => $location,
-			GoogleMapsRequestFields::RADIUS   => $radius
-		]);
-
-		return $this->findNearbyPlace($params);
-	}
-
-	/**
-	 * Nearby Search requests
-	 *
-	 * @param array $params
-	 *
-	 * @return GoogleMapsResultsCollection
-	 *
-	 * @throws InvalidArgumentException
-	 * @see     https://developers.google.com/places/web-service/search#PlaceSearchRequests
-	 * @since   0.5.0
-	 */
-	public function findNearbyPlace(array $params): GoogleMapsResultsCollection
-	{
-
-		if (!empty($params[GoogleMapsRequestFields::LOCATION])) {//-33.8670522,151.1957362
-			$location = $params[GoogleMapsRequestFields::LOCATION];
-			if (!$location instanceof Location) {
-				throw new InvalidArgumentException(GoogleMapsRequestFields::LOCATION . ' field must be instance of ' . Location::class . ' class');
-			}
-			$params[GoogleMapsRequestFields::LOCATION] = (string)$params[GoogleMapsRequestFields::LOCATION];
-		} else {
-			throw new InvalidArgumentException(GoogleMapsResultFields::LOCATION . ' field is required');
-		}
-
-		if (!empty($params[GoogleMapsRequestFields::RANKBY]) &&
-			$params[GoogleMapsRequestFields::RANKBY] === RankByValues::DISTANCE
-		) {
-			if (empty($params[GoogleMapsRequestFields::KEYWORD]) &&
-				empty($params[GoogleMapsRequestFields::NAME]) &&
-				empty($params[GoogleMapsRequestFields::TYPE])) {
+    /**
+     * @var string
+     */
+    const SERVICE_ENDPOINT = 'place';
+
+    /**
+     * @var string
+     */
+    protected $result_type = PlacesResult::class;
+
+    /**
+     * @var string
+     */
+    protected $result_collection_type = PlaceResultsCollection::class;
+
+    /**
+     * @param string     $query
+     * @param array|null $params
+     * @param array|null $fields
+     *
+     * @return GoogleMapsResultsCollection
+     * @see https://developers.google.com/places/web-service/search#FindPlaceRequests
+     */
+    public function findPlaceByText(
+        string $query,
+        ?array $params = [],
+        ?array $fields = []
+    ): GoogleMapsResultsCollection {
+
+        $params = array_merge($params, [
+            GoogleMapsRequestFields::INPUT  => $query,
+            GoogleMapsRequestFields::FIELDS => implode(',', $fields)
+        ]);
+
+        return $this->findPlace($params);
+
+    }
+
+    /**
+     * Find Places requests
+     *
+     * @param array $params
+     *        GoogleMapsRequestFields::INPUT required
+     *
+     * @see     https://developers.google.com/places/web-service/search#FindPlaceRequests
+     * @return GoogleMapsResultsCollection
+     * @throws InvalidArgumentException
+     * @since   0.5.0
+     */
+    public function findPlace(array $params): GoogleMapsResultsCollection
+    {
+
+        // see \Biscolab\GoogleMaps\Values\PlaceInputTypeValues
+        if (empty($params[GoogleMapsRequestFields::INPUTTYPE])) {
+            $params[GoogleMapsRequestFields::INPUTTYPE] = PlaceInputTypeValues::TEXTQUERY;
+        }
+
+        if (empty($params[GoogleMapsRequestFields::INPUT])) {
+            throw new InvalidArgumentException(GoogleMapsRequestFields::INPUT . " field is required");
+        }
+
+        return $this->makeApiCall($params, PlaceServicesEndpoints::FINDPLACEFROMTEXT);
+    }
+
+    /**
+     * @param array  $params
+     * @param string $endpoint
+     *
+     * @return GoogleMapsResult|GoogleMapsResultsCollection
+     * @since   0.5.0
+     */
+    public function makeApiCall(array $params, string $endpoint)
+    {
+
+        return $this->callApi($params, $endpoint);
+    }
+
+    /**
+     * @param string     $number
+     * @param array|null $params
+     * @param array|null $fields
+     *
+     * @return GoogleMapsResultsCollection
+     */
+    public function findPlaceByPhoneNumber(
+        string $number,
+        ?array $params = [],
+        ?array $fields = []
+    ): GoogleMapsResultsCollection {
+
+        $params = array_merge($params, [
+            GoogleMapsRequestFields::INPUT     => $number,
+            GoogleMapsRequestFields::INPUTTYPE => PlaceInputTypeValues::PHONENUMBER,
+            GoogleMapsRequestFields::FIELDS    => implode(',', $fields)
+        ]);
+
+        return $this->findPlace($params);
+
+    }
+
+    /**
+     * @param Location   $location
+     * @param int        $radius
+     * @param array|null $params
+     *
+     * @return GoogleMapsResultsCollection
+     */
+    public function findNearbyPlaceByRadius(
+        Location $location,
+        int $radius,
+        ?array $params = []
+    ): GoogleMapsResultsCollection {
+
+        $params = array_merge($params, [
+            GoogleMapsRequestFields::LOCATION => $location,
+            GoogleMapsRequestFields::RADIUS   => $radius
+        ]);
+
+        return $this->findNearbyPlace($params);
+    }
+
+    /**
+     * Nearby Search requests
+     *
+     * @param array $params
+     *
+     * @return GoogleMapsResultsCollection
+     *
+     * @throws InvalidArgumentException
+     * @see     https://developers.google.com/places/web-service/search#PlaceSearchRequests
+     * @since   0.5.0
+     */
+    public function findNearbyPlace(array $params): GoogleMapsResultsCollection
+    {
+
+        if (!empty($params[GoogleMapsRequestFields::LOCATION])) {//-33.8670522,151.1957362
+            $location = $params[GoogleMapsRequestFields::LOCATION];
+            if (!$location instanceof Location) {
+                throw new InvalidArgumentException(GoogleMapsRequestFields::LOCATION . ' field must be instance of ' . Location::class . ' class');
+            }
+            $params[GoogleMapsRequestFields::LOCATION] = (string)$params[GoogleMapsRequestFields::LOCATION];
+        } else {
+            throw new InvalidArgumentException(GoogleMapsResultFields::LOCATION . ' field is required');
+        }
+
+        if (!empty($params[GoogleMapsRequestFields::RANKBY]) &&
+            $params[GoogleMapsRequestFields::RANKBY] === RankByValues::DISTANCE
+        ) {
+            if (empty($params[GoogleMapsRequestFields::KEYWORD]) &&
+                empty($params[GoogleMapsRequestFields::NAME]) &&
+                empty($params[GoogleMapsRequestFields::TYPE])) {
 //				If rankby=distance (described under Optional parameters below) is specified,
 // 				then one or more of keyword, name, or type is required.
-				throw new InvalidArgumentException('If ' . GoogleMapsRequestFields::RANKBY . ' is set as "' . RankByValues::DISTANCE . '" one or more of ' . GoogleMapsRequestFields::KEYWORD . ', ' . GoogleMapsRequestFields::NAME . ', ' . GoogleMapsRequestFields::TYPE . ' fields are required');
-			}
-			if (!empty($params[GoogleMapsRequestFields::RADIUS])) {
+                throw new InvalidArgumentException('If ' . GoogleMapsRequestFields::RANKBY . ' is set as "' . RankByValues::DISTANCE . '" one or more of ' . GoogleMapsRequestFields::KEYWORD . ', ' . GoogleMapsRequestFields::NAME . ', ' . GoogleMapsRequestFields::TYPE . ' fields are required');
+            }
+            if (!empty($params[GoogleMapsRequestFields::RADIUS])) {
 // 				Note that radius must not be included if rankby=distance (described under Optional parameters below) is specified.
-				throw new InvalidArgumentException(GoogleMapsRequestFields::RADIUS . ' must not be included if ' . GoogleMapsRequestFields::RANKBY . ' = ' . RankByValues::DISTANCE);
-			}
-		} elseif (empty($params[GoogleMapsRequestFields::RADIUS])) {
+                throw new InvalidArgumentException(GoogleMapsRequestFields::RADIUS . ' must not be included if ' . GoogleMapsRequestFields::RANKBY . ' = ' . RankByValues::DISTANCE);
+            }
+        } elseif (empty($params[GoogleMapsRequestFields::RADIUS])) {
 //			radius — Defines the distance (in meters) within which to return place results.
-			throw new InvalidArgumentException(GoogleMapsRequestFields::RADIUS . ' field is required');
-		}
+            throw new InvalidArgumentException(GoogleMapsRequestFields::RADIUS . ' field is required');
+        }
 
-		if (!empty($params[GoogleMapsRequestFields::RADIUS]) && floatval($params[GoogleMapsRequestFields::RADIUS]) > Config::MAX_PLACE_RADIUS_VALUE) {
+        if (!empty($params[GoogleMapsRequestFields::RADIUS]) && floatval($params[GoogleMapsRequestFields::RADIUS]) > Config::MAX_PLACE_RADIUS_VALUE) {
 // 			The maximum allowed radius is 50 000 meters.
-			throw new InvalidArgumentException(GoogleMapsRequestFields::RADIUS . ' must be lower than ' . Config::MAX_PLACE_RADIUS_VALUE);
-		}
-
-		return $this->makeApiCall($params, PlaceServicesEndpoints::NEARBYSEARCH);
-	}
-
-	/**
-	 * @param Location $location
-	 * @param array    $params
-	 *
-	 * @return GoogleMapsResultsCollection
-	 */
-	public function findNearbyPlaceByDistance(Location $location, array $params): GoogleMapsResultsCollection
-	{
-
-		$params = array_merge($params, [
-			GoogleMapsRequestFields::LOCATION => $location,
-			GoogleMapsRequestFields::RANKBY   => RankByValues::DISTANCE
-		]);
-
-		return $this->findNearbyPlace($params);
-	}
-
-	/**
-	 * Nearby Search requests
-	 *
-	 * @param string     $query
-	 * @param array|null $params
-	 *
-	 * @see     https://developers.google.com/places/web-service/search#TextSearchRequests
-	 * @return GoogleMapsResultsCollection
-	 * @throws InvalidArgumentException
-	 * @since   0.5.0
-	 */
-	public function textSearch(string $query, ?array $params = []): GoogleMapsResultsCollection
-	{
-
-		$params = array_merge($params, [
-			GoogleMapsRequestFields::QUERY => $query
-		]);
-
-		return $this->makeApiCall($params, PlaceServicesEndpoints::TEXTSEARCH);
-	}
-
-	/**
-	 * @param string     $place_id
-	 * @param array|null $params
-	 *
-	 * @return GoogleMapsResult
-	 * @see https://developers.google.com/places/web-service/details
-	 * @since v0.6.0
-	 */
-	public function details(string $place_id, ?array $params = []): GoogleMapsResult
-	{
-
-		$params = array_merge($params, [
-			GoogleMapsRequestFields::PLACE_ID => $place_id
-		]);
-
-		return $this->makeApiCall($params, PlaceServicesEndpoints::DETAILS);
-
-	}
+            throw new InvalidArgumentException(GoogleMapsRequestFields::RADIUS . ' must be lower than ' . Config::MAX_PLACE_RADIUS_VALUE);
+        }
+
+        return $this->makeApiCall($params, PlaceServicesEndpoints::NEARBYSEARCH);
+    }
+
+    /**
+     * @param Location $location
+     * @param array    $params
+     *
+     * @return GoogleMapsResultsCollection
+     */
+    public function findNearbyPlaceByDistance(Location $location, array $params): GoogleMapsResultsCollection
+    {
+
+        $params = array_merge($params, [
+            GoogleMapsRequestFields::LOCATION => $location,
+            GoogleMapsRequestFields::RANKBY   => RankByValues::DISTANCE
+        ]);
+
+        return $this->findNearbyPlace($params);
+    }
+
+    /**
+     * Nearby Search requests
+     *
+     * @param string     $query
+     * @param array|null $params
+     *
+     * @see     https://developers.google.com/places/web-service/search#TextSearchRequests
+     * @return GoogleMapsResultsCollection
+     * @throws InvalidArgumentException
+     * @since   0.5.0
+     */
+    public function textSearch(string $query, ?array $params = []): GoogleMapsResultsCollection
+    {
+
+        $params = array_merge($params, [
+            GoogleMapsRequestFields::QUERY => $query
+        ]);
+
+        return $this->makeApiCall($params, PlaceServicesEndpoints::TEXTSEARCH);
+    }
+
+    /**
+     * @param string     $place_id
+     * @param array|null $params
+     *
+     * @return GoogleMapsResult
+     * @see https://developers.google.com/places/web-service/details
+     * @since v0.6.0
+     */
+    public function details(string $place_id, ?array $params = []): GoogleMapsResult
+    {
+
+        $params = array_merge($params, [
+            GoogleMapsRequestFields::PLACE_ID => $place_id
+        ]);
+
+        return $this->makeApiCall($params, PlaceServicesEndpoints::DETAILS);
+
+    }
 
 }
\ No newline at end of file