Public/Get-GmapPlaceNearby.ps1
|
Function Get-GmapPlaceNearby { <# .SYNOPSIS This function finds places that are nearby the specified $Latitude and $Longitude within the search $Radius .DESCRIPTION This function finds places that are nearby the specified $Latitude and $Longitude within the search $Radius. Uses the Google API Places API. .EXAMPLE Get-GmapGeoCode -Address "123 Main St, New York, NY" | Get-GmapPlaceNearby -Radius 15 This first runs the Get-GmapGeoCode on an address and the object returned will have a Latitude and Longitude property. That object is then piped to this function, which finds places within 15 meters. .EXAMPLE $CruiseNearby = Get-GmapGeoCode -Address "123 Main St, New York, NY" | Get-GmapPlaceNearby -Radius 100 -options '{"keyword":"cruise"}' -Verbose $CruiseNearby This first runs the Get-GmapGeoCode on an address and the object returned will have a Latitude and Longitude property. That object is then piped to this function, which finds places within 100 meters that match the keyword cruise. .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)] $Radius, [Parameter(Mandatory=$True, ValueFromPipelinebyPropertyName=$true)] $Latitude, [Parameter(Mandatory=$True, ValueFromPipelinebyPropertyName=$true)] $Longitude, [Parameter(Mandatory=$False)] $options ) Begin{} Process { $Location = "$($Latitude),$($Longitude)" Write-Verbose "Using location of $Location" If($options) { $url = $BaseUri + 'place/nearbysearch/json?location=' + $Location + '&' + 'radius=' + $Radius + '&' + $(New-GmapQuery -ApiKey $GPlacesApiKey -options $options) } else { $url = $BaseUri + 'place/nearbysearch/json?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-GmapPlaceNearby # 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 } } } |