Search-GmapNearbyPlace.ps1

Function Search-GmapNearbyPlace
{
    <#
    .SYNOPSIS
        This will send a text query and return an object of place information back.
    .DESCRIPTION
        This will send a text query and return an object of place information back.
        Uses the Google Places API.
    .EXAMPLE
        Search-GmapNearbyPlace -Query "Pizza in New York"

        This will send a text query of "Pizza in New York" to the Google Places textsearch API endpoint.
        The object(s) returned will have information about the places found.
    
    .EXAMPLE
        Get-GmapGeoCode -Address "123 Main St, New York, NY" | Search-GmapNearbyPlace -Query "Pizza in New York" -Radius 250 -Verbose

        First the Get-GmapGeoCode function is run for that adddress. The object returned (which has Latitude and Longitude property) is then piped to this function.
        The Latitude and Longitude parameters require a Radius parameter, which was specified as 250. Which should find matches within 250 meters. The -Verbose parameter
        is used to display the Write-Verbose messages. All of the functions in this module support the -Verbose parameter.

    .NOTES
        Requires an active Google Place API Key. This key should be set to the moduel variable `$GPlacesApiKey.
        Refer to https://developers.google.com/places/web-service/intro
    #>
    [CmdletBinding()]
    param 
    (
		[Parameter(Mandatory=$True)]            
        $Query,
		[Parameter(Mandatory=$False,
		ValueFromPipelinebyPropertyName=$true,ParameterSetName="Location")]          
        $Latitude,
		[Parameter(Mandatory=$False,
		ValueFromPipelinebyPropertyName=$true,ParameterSetName="Location")]            
        $Longitude,
		[Parameter(Mandatory=$True,ParameterSetName="Location")]            
        $Radius,        
		[Parameter(Mandatory=$False)]            
        $options         
    )
    Begin{}
    Process
    {
        If($PSCmdlet.ParameterSetName -eq "Location")
        {
            $Location = "$($Latitude),$($Longitude)"
            Write-Verbose "Using location of $Location"
            If($options)
            {
                $url = $BaseUri + 'place/textsearch/json?query=' + $Query + '&' + 'location=' + $Location + '&' + 'radius=' + $Radius + $(New-GmapQuery -ApiKey $GPlacesApiKey -options $options)
            }
            else 
            {
                $url = $BaseUri + 'place/textsearch/json?query=' + $Query  + '&' + 'location=' + $Location + '&' + 'radius=' + $Radius + $(New-GmapQuery -ApiKey $GPlacesApiKey)
            }
            Write-Verbose "Sending Url of $url"        
            $Results = Invoke-RestMethod -Uri $url # Refer to here https://developers.google.com/places/web-service/details for more info about returned properties
            If($Results.status -eq 'OK')
            {
                $Results = $Results.results # get the results from json data returned from Google API
                $Results | Format-GmapPlaceSearch  # send it to function which adds ScriptProperties and ScriptMethods, sets Default Display Set
            }
            else 
            {
                Write-Warning "Did not get succcessful return from Google API"
                $Results            
            }            
        }
        else 
        {
            If($options)
            {
                $url = $BaseUri + 'place/textsearch/json?query=' + $Query + '&' + 'radius=' + $Radius + $(New-GmapQuery -ApiKey $GPlacesApiKey -options $options)
            }
            else 
            {
                $url = $BaseUri + 'place/textsearch/json?query=' + $Query + '&' + 'radius=' + $Radius + $(New-GmapQuery -ApiKey $GPlacesApiKey)
            }
            Write-Verbose "Sending Url of $url"        
            $Results = Invoke-RestMethod -Uri $url # Refer to here https://developers.google.com/places/web-service/details for more info about returned properties
            If($Results.status -eq 'OK')
            {
                $Results = $Results.results # get the results from json data returned from Google API
                $Results | Format-GmapPlaceSearch  # send it to function which adds ScriptProperties and ScriptMethods, sets Default Display Set
            }
            else 
            {
                Write-Warning "Did not get succcessful return from Google API"
                $Results            
            }
        }

    }    
}