Get-GmapPlaceDetails.ps1

Function Get-GmapPlaceDetails
{
    <#
    .SYNOPSIS
        This function gets information about a place_id returned by Google or provided by the person running the function.
    .DESCRIPTION
        This function gets information about a place_id returned by Google or provided by the person running the function.
        Uses the Google Places API Web Service.
    .EXAMPLE
        Get-GmapGeoCode -Address "123 Main St, New York, NY" | Get-GmapPlaceDetails
        This first runs the function Get-GmapGeoCode which the object returned will have a place_id property. That object is then piped
        to this function, to return addition details about that location from the Google Places API.

    .EXAMPLE
        $Details = Get-GmapGeoCode -Address "123 Main St, New York, NY" | Get-GmapPlaceDetails
        $Details | Format-List *
        $Details.OpenMap()

        This stores the information into a variable. Then that variable is piped to Format-List * to show the additional properites that are returned.
        Then the OpenMap() method is called from that variable which will open a Google Map in the default browser on the computer running this function.

    .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=$False,
		ValueFromPipeline=$True, ValueFromPipelinebyPropertyName=$true)]            
        [string]$place_id,
		[Parameter(Mandatory=$False)]            
        $options         
    )
    Begin{}
    Process
    {
        If($options)
        {
            $url = $BaseUri + 'place/details/json?placeid=' + $place_id + '&' + $(New-GmapQuery -ApiKey $GPlacesApiKey -options $options)
        }
        else 
        {
            $url = $BaseUri + 'place/details/json?placeid=' + $place_id + $(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.result # get the result from json data returned from Google API
            $Results | Format-GmapPlaceDetail # 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            
        }
    }    
}