Skip to content

Commit

Permalink
minor corrections
Browse files Browse the repository at this point in the history
  • Loading branch information
techthoughts2 committed Oct 11, 2021
1 parent ae6d004 commit 8da266a
Show file tree
Hide file tree
Showing 20 changed files with 62 additions and 62 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,14 +49,14 @@ To use pwshPlaces you will require a Google Maps or Bing Maps API key. To use al

> 🙄 Not another module that requires an API Key!
Both of these APIs are *easy to create* and have *no cost* pricing tiers which should meet your needs. I have provided detailed guides on how to get your API keys:
Both of these Map API keys are *easy to create* and have *no cost* pricing tiers which should meet your needs. I have provided detailed guides on how to get your API keys:

* [How to get a Google Maps API Key](docs/GoogleMapsAPI.md#how-to-get-a-google-maps-api-key)
* [How to get a Bing Maps API Key](docs/BingMapsAPI.md#how-to-get-a-bing-maps-api-key)

```powershell
# Set your API Keys in the pwshPlaces.psm1 file
# using the approriate variable names:
# using the appropriate variable names:
$env:GoogleAPIKey = 'yourGoogleAPIKey'
$env:BingAPIKey = 'yourBingAPIKey'
Expand Down
8 changes: 4 additions & 4 deletions docs/BingMapsAPI.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Log into the [Bing Maps Dev Center Portal](https://www.bingmapsportal.com) - if
#### 2. Create a Bing Maps Basic API Key

- Under My account tab click *My Keys*
- Create a new api key
- Create a new API key

![Bing Maps API Key Choices](../media/create_bing_maps_api_key.PNG 'Bing Map API Key Choice')
![Bing Maps Dev Center New API Key](../media/bing_map_create_api_key.PNG 'New Bing Maps API Key')
Expand Down Expand Up @@ -71,12 +71,12 @@ $scrapePath = $env:Temp
$locale = Invoke-BingGeoCode -Query 'New Braunfels, TX'
$areaRestaraunts = Search-BingNearbyPlace -Type Restaurants -PointLatitude $locale.Latitude -PointLongitude $locale.Longitude -MaxResults 20
$areaRestaurants = Search-BingNearbyPlace -Type Restaurants -PointLatitude $locale.Latitude -PointLongitude $locale.Longitude -MaxResults 20
ConvertTo-Clixml -InputObject $areaRestaraunts -Depth 100 | Out-File "$scrapePath\localRestaraunts.xml"
ConvertTo-Clixml -InputObject $areaRestaurants -Depth 100 | Out-File "$scrapePath\localRestaurants.xml"
#--------------------------------------------------------------
# where should we eat today?
$myLocalRestaurants = Get-Content -Path "$scrapePath\localRestaraunts.xml" -Raw | ConvertFrom-Clixml
$myLocalRestaurants = Get-Content -Path "$scrapePath\localRestaurants.xml" -Raw | ConvertFrom-Clixml
Get-Random $myLocalRestaurants
```
8 changes: 4 additions & 4 deletions docs/Find-BingPlace.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Find-BingPlace [-Query <String>] [-PointLatitude <String>] [-PointLongitude <Str
## DESCRIPTION
Performs a find place request with provided parameters.
A text search is performed that returns a list of business entities.
By default the location bias is IP based.
By default, the location bias is IP based.
Location bias and language can be controlled via parameters.

## EXAMPLES
Expand All @@ -58,7 +58,7 @@ Returns place information for the query location biased by IP.
Find-BingPlace -Query "Krause's cafe" -Language es
```

Returns place information for the query location biased by IP and returns a few portion of the results in Spanish.
Returns place information for the query location biased by IP and returns a few portions of the results in Spanish.

### EXAMPLE 3
```
Expand Down Expand Up @@ -147,7 +147,7 @@ Accept wildcard characters: False
```
### -PointLongitude
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earths surface.
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down Expand Up @@ -177,7 +177,7 @@ Accept wildcard characters: False
```
### -CircleLongitude
Prefer results in a specified area by specifying a radius plus lat/long - east-west position of a point on the Earths surface.
Prefer results in a specified area by specifying a radius plus lat/long - east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down
2 changes: 1 addition & 1 deletion docs/Find-BingTimeZone.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ Accept wildcard characters: False
```
### -PointLongitude
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earths surface.
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down
6 changes: 3 additions & 3 deletions docs/Find-GMapPlace.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Find-GMapPlace [-Query <String>] [-PointLatitude <String>] [-PointLongitude <Str
Performs a find place request with provided parameters.
A text search is performed unless a properly formatted phone number is provided in which case
a phonenumber search is completed.
By default the location bias and language is IP based.
By default, the location bias and language is IP based.
Location bias and language can be controlled via parameters.
The information returned in a normal
call contains all basic field types.
Expand Down Expand Up @@ -169,7 +169,7 @@ Accept wildcard characters: False
```
### -PointLongitude
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earths surface.
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down Expand Up @@ -199,7 +199,7 @@ Accept wildcard characters: False
```
### -CircleLongitude
Prefer results in a specified area by specifying a radius plus lat/long - east-west position of a point on the Earths surface.
Prefer results in a specified area by specifying a radius plus lat/long - east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down
6 changes: 3 additions & 3 deletions docs/GoogleMapsAPI.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,12 +122,12 @@ $scrapePath = $env:Temp
$locale = Invoke-GMapGeoCode -Address 'New Braunfels'
$areaRestaraunts = Search-GMapNearbyPlace -Latitude $locale.Latitude -Longitude $locale.Longitude -Radius 10000 -RankByProminence -Type restaurant -AllSearchResults
$areaRestaurants = Search-GMapNearbyPlace -Latitude $locale.Latitude -Longitude $locale.Longitude -Radius 10000 -RankByProminence -Type restaurant -AllSearchResults
ConvertTo-Clixml -InputObject $areaRestaraunts -Depth 100 | Out-File "$scrapePath\localRestaraunts.xml"
ConvertTo-Clixml -InputObject $areaRestaurants -Depth 100 | Out-File "$scrapePath\localRestaurants.xml"
#--------------------------------------------------------------
# where should we eat today?
$myLocalRestaurants = Get-Content -Path "$scrapePath\localRestaraunts.xml" -Raw | ConvertFrom-Clixml
$myLocalRestaurants = Get-Content -Path "$scrapePath\localRestaurants.xml" -Raw | ConvertFrom-Clixml
Get-Random $myLocalRestaurants
```
8 changes: 4 additions & 4 deletions docs/Invoke-BingGeoCode.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Invoke-BingGeoCode -Query <String> [-Language <languages>] [-MaxResults <Int32>]
```

## DESCRIPTION
Geocoding is the process of converting addresses addresses (like "1600 Amphitheatre Parkway, Mountain View, CA") into geographic coordinates.
Geocoding is the process of converting addresses (like "1600 Amphitheatre Parkway, Mountain View, CA") into geographic coordinates.
This function can take in an address and return coordinate information.
You can also provide coordinates to return multiple nearby address results.

Expand Down Expand Up @@ -182,7 +182,7 @@ Accept wildcard characters: False
```
### -Longitude
Geographic coordinate that specifies the east-west position of a point on the Earths surface.
Geographic coordinate that specifies the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down Expand Up @@ -229,7 +229,7 @@ Accept wildcard characters: False
### -MaxResults
Specifies the maximum number of locations to return in the response.
If not specified the default is 5.
If not specified, the default is 5.
```yaml
Type: Int32
Expand Down Expand Up @@ -258,7 +258,7 @@ Author: Jake Morrison - @jakemorrison - https://www.techthoughts.info/
Example:
http://dev.virtualearth.net/REST/v1/Locations?countryRegion={countryRegion}&adminDistrict={adminDistrict}&locality={locality}&postalCode={postalCode}&addressLine={addressLine}&userLocation={userLocation}&userIp={userIp}&usermapView={usermapView}&includeNeighborhood={includeNeighborhood}&maxResults={maxResults}&key={BingMapsKey}
While the Bing Location API does support a text query option, I have found it to be fairly unreliable.
While the Bing Location API does support a text query option, I have found it to be unreliable.
For GeoCode info stick to Addresses and Lat/Long for reverse Geocoding.
For Text Queries use other Bing Maps functions.
Expand Down
4 changes: 2 additions & 2 deletions docs/Invoke-GMapGeoCode.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Invoke-GMapGeoCode -PlaceID <String> [-Language <languages>] [-RegionBias <ccTLD
```

## DESCRIPTION
Geocoding is the process of converting addresses addresses (like "1600 Amphitheatre Parkway, Mountain View, CA") into geographic coordinates.
Geocoding is the process of converting addresses (like "1600 Amphitheatre Parkway, Mountain View, CA") into geographic coordinates.
This function can take in an address and return coordinate information.
You can also provide coordinates to return multiple nearby address results.
If you know the exact google placeID this can also be provided to return Geocoding information about that location.
Expand Down Expand Up @@ -99,7 +99,7 @@ Accept wildcard characters: False
```
### -Longitude
Geographic coordinate that specifies the east-west position of a point on the Earths surface.
Geographic coordinate that specifies the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down
8 changes: 4 additions & 4 deletions docs/Search-BingNearbyPlace.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ Search-BingNearbyPlace -Type Museums -PointLatitude '29.7049806' -PointLongitude
```

Performs a nearby search near the provided Lat/Long and returns Museum places types.
Results are returned in english with a maximum of 20 results returned.
Results are returned in English with a maximum of 20 results returned.

### EXAMPLE 7
```
Expand All @@ -103,7 +103,7 @@ Search-BingNearbyPlace @searchBingNearbyPlaceSplat
```

Performs a nearby search near the provided Lat/Long and returns Museum places types.
Results are returned in english with a maximum of 20 results returned.
Results are returned in English with a maximum of 20 results returned.

## PARAMETERS

Expand Down Expand Up @@ -152,7 +152,7 @@ Accept wildcard characters: False
```
### -PointLongitude
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earths surface.
Prefer results in a specified area by specifying a single coordinate for the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down Expand Up @@ -182,7 +182,7 @@ Accept wildcard characters: False
```
### -CircleLongitude
Prefer results in a specified area by specifying a radius plus lat/long - east-west position of a point on the Earths surface.
Prefer results in a specified area by specifying a radius plus lat/long - east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down
6 changes: 3 additions & 3 deletions docs/Search-GMapNearbyPlace.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Search-GMapNearbyPlace -Latitude <String> -Longitude <String> -Radius <String> [
## DESCRIPTION
Performs a nearby search request with provided parameters.
Nearby search is useful for finding places near a specific geographic location.
By default 20 results are returned from a standard search.
By default, 20 results are returned from a standard search.
You can increase this to a maximum of 60 places results by providing the AllSearchResults switch.

## EXAMPLES
Expand Down Expand Up @@ -85,7 +85,7 @@ Search-GMapNearbyPlace -Latitude '26.1202' -Longitude '127.7025' -Radius 10000 -
```

Performs a nearby search and returns only amusement parks places near provided coordinates within a range of 10000 meters.
Results are ranked by prominence and returned in Engish.
Results are ranked by prominence and returned in English.

### EXAMPLE 7
```
Expand Down Expand Up @@ -138,7 +138,7 @@ Accept wildcard characters: False
```
### -Longitude
Geographic coordinate that specifies the east-west position of a point on the Earths surface.
Geographic coordinate that specifies the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down
10 changes: 5 additions & 5 deletions docs/Search-GMapText.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Search-GMapText [-Query <String>] -Latitude <String> -Longitude <String> [-Type
Text based search for finding places based on a provided string and optional parameters.
Text search is especially useful for making ambiguous queries when searching for places.
Returned results can be heavily biased based on factors such as including a location in
the query iteself, or by providing direct location information in optional parameters.
the query itself, or by providing direct location information in optional parameters.
By default 20 results are returned from a standard search.
You can increase this to a maximum of 60 places results by providing the AllSearchResults switch.

Expand Down Expand Up @@ -86,7 +86,7 @@ Places results are biased to the region of Spain.
Search-GMapText -Query "italian restaurants in New York" -MinPrice 4
```

Performs a text search with the provided query and returns expensive restaraunt options.
Performs a text search with the provided query and returns expensive restaurant options.
Since a location is provided in the query, places results will be biased by that location.

### EXAMPLE 6
Expand Down Expand Up @@ -144,7 +144,7 @@ Only restaurant places are returned.
Results are returned based on the provided coordiantes and are ranked by their distance from the coordinates.
Places data is returned in English.
Results with a cheap to moderate price are returned.
Only restaraunts that are currently open are returned.
Only restaurants that are currently open are returned.
The maximum of 60 places results is returned.

### EXAMPLE 12
Expand All @@ -169,7 +169,7 @@ Only restaurant places are returned.
Results are returned based on the provided coordiantes and are ranked by their distance from the coordinates.
Places data is returned in English.
Results with a cheap to moderate price are returned.
Only restaraunts that are currently open are returned.
Only restaurants that are currently open are returned.
The maximum of 60 places results is returned.

## PARAMETERS
Expand Down Expand Up @@ -229,7 +229,7 @@ Accept wildcard characters: False
```
### -Longitude
Geographic coordinate that specifies the east-west position of a point on the Earths surface.
Geographic coordinate that specifies the east-west position of a point on the Earth's surface.
```yaml
Type: String
Expand Down
2 changes: 1 addition & 1 deletion docs/pwshPlaces-FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ You can dive into more details by [Understanding Bing Maps API pricing](BingMaps

```powershell
# Set your API Keys in the pwshPlaces.psm1 file
# using the approriate variable names:
# using the appropriate variable names:
$env:GoogleAPIKey = 'yourGoogleAPIKey'
$env:BingAPIKey = 'yourBingAPIKey'
Expand Down
8 changes: 4 additions & 4 deletions src/pwshPlaces/Public/Find-BingPlace.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
.DESCRIPTION
Performs a find place request with provided parameters.
A text search is performed that returns a list of business entities.
By default the location bias is IP based.
By default, the location bias is IP based.
Location bias and language can be controlled via parameters.
.EXAMPLE
Find-BingPlace -Query "Krause's cafe"
Expand All @@ -13,7 +13,7 @@
.EXAMPLE
Find-BingPlace -Query "Krause's cafe" -Language es
Returns place information for the query location biased by IP and returns a few portion of the results in Spanish.
Returns place information for the query location biased by IP and returns a few portions of the results in Spanish.
.EXAMPLE
Find-BingPlace -Query 'cafe' -PointLatitude '29.7049806' -PointLongitude '-98.068343'
Expand Down Expand Up @@ -46,11 +46,11 @@
.PARAMETER PointLatitude
Prefer results in a specified area by specifying a single coordinate for the north–south position of a point on the Earth's surface.
.PARAMETER PointLongitude
Prefer results in a specified area by specifying a single coordinate for the east–west position of a point on the Earths surface.
Prefer results in a specified area by specifying a single coordinate for the east–west position of a point on the Earth's surface.
.PARAMETER CircleLatitude
Prefer results in a specified area by specifying a radius plus lat/long - north–south position of a point on the Earth's surface.
.PARAMETER CircleLongitude
Prefer results in a specified area by specifying a radius plus lat/long - east–west position of a point on the Earths surface.
Prefer results in a specified area by specifying a radius plus lat/long - east–west position of a point on the Earth's surface.
.PARAMETER CircleRadius
Prefer results in a specified area by specifying a radius plus lat/long - radius in meters
.PARAMETER SouthLatitude
Expand Down
2 changes: 1 addition & 1 deletion src/pwshPlaces/Public/Find-BingTimeZone.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
.PARAMETER PointLatitude
Prefer results in a specified area by specifying a single coordinate for the north–south position of a point on the Earth's surface.
.PARAMETER PointLongitude
Prefer results in a specified area by specifying a single coordinate for the east–west position of a point on the Earths surface.
Prefer results in a specified area by specifying a single coordinate for the east–west position of a point on the Earth's surface.
.PARAMETER RegionBias
The region code, specified as a ccTLD ("top-level domain") two-character value.
.PARAMETER Language
Expand Down
6 changes: 3 additions & 3 deletions src/pwshPlaces/Public/Find-GMapPlace.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
.DESCRIPTION
Performs a find place request with provided parameters.
A text search is performed unless a properly formatted phone number is provided in which case
a phonenumber search is completed. By default the location bias and language is IP based.
a phonenumber search is completed. By default, the location bias and language is IP based.
Location bias and language can be controlled via parameters. The information returned in a normal
call contains all basic field types. Additional field types including contact and atmosphere information
can be called for but these carry an additional cost. The Find Place return does not return
Expand Down Expand Up @@ -58,11 +58,11 @@
.PARAMETER PointLatitude
Prefer results in a specified area by specifying a single coordinate for the north–south position of a point on the Earth's surface.
.PARAMETER PointLongitude
Prefer results in a specified area by specifying a single coordinate for the east–west position of a point on the Earths surface.
Prefer results in a specified area by specifying a single coordinate for the east–west position of a point on the Earth's surface.
.PARAMETER CircleLatitude
Prefer results in a specified area by specifying a radius plus lat/long - north–south position of a point on the Earth's surface.
.PARAMETER CircleLongitude
Prefer results in a specified area by specifying a radius plus lat/long - east–west position of a point on the Earths surface.
Prefer results in a specified area by specifying a radius plus lat/long - east–west position of a point on the Earth's surface.
.PARAMETER CircleRadius
Prefer results in a specified area by specifying a radius plus lat/long - radius in meters
.PARAMETER SouthLatitude
Expand Down
Loading

0 comments on commit 8da266a

Please sign in to comment.