{"id":16385936,"url":"https://github.com/techthoughts2/pwshplaces","last_synced_at":"2025-08-28T23:49:08.617Z","repository":{"id":99419167,"uuid":"405531328","full_name":"techthoughts2/pwshPlaces","owner":"techthoughts2","description":"pwshPlaces is a PowerShell module that can help you discover places and search for points of interest around the globe.","archived":false,"fork":false,"pushed_at":"2024-01-15T05:22:27.000Z","size":1271,"stargazers_count":16,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-19T09:25:24.445Z","etag":null,"topics":["api","api-rest","bing-maps","geolocation","gmaps","gmaps-api","google-maps","google-maps-api","latitude-and-longitude","location","map","maps","places","powershell","powershell-module","timezone"],"latest_commit_sha":null,"homepage":"https://pwshplaces.readthedocs.io/","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/techthoughts2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-09-12T02:53:36.000Z","updated_at":"2025-04-09T10:19:21.000Z","dependencies_parsed_at":"2024-01-15T05:59:13.859Z","dependency_job_id":null,"html_url":"https://github.com/techthoughts2/pwshPlaces","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/techthoughts2/pwshPlaces","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techthoughts2%2FpwshPlaces","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techthoughts2%2FpwshPlaces/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techthoughts2%2FpwshPlaces/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techthoughts2%2FpwshPlaces/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/techthoughts2","download_url":"https://codeload.github.com/techthoughts2/pwshPlaces/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/techthoughts2%2FpwshPlaces/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272582506,"owners_count":24959419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-28T02:00:10.768Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-rest","bing-maps","geolocation","gmaps","gmaps-api","google-maps","google-maps-api","latitude-and-longitude","location","map","maps","places","powershell","powershell-module","timezone"],"created_at":"2024-10-11T04:15:43.950Z","updated_at":"2025-08-28T23:49:08.573Z","avatar_url":"https://github.com/techthoughts2.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pwshPlaces\n\n[![Minimum Supported PowerShell Version](https://img.shields.io/badge/PowerShell-5.1+-purple.svg)](https://github.com/PowerShell/PowerShell) [![PowerShell Gallery][psgallery-img]][psgallery-site] ![Cross Platform](https://img.shields.io/badge/platform-windows%20%7C%20macos%20%7C%20linux-lightgrey) [![License][license-badge]](LICENSE) [![Documentation Status](https://readthedocs.org/projects/pwshplaces/badge/?version=latest)](https://pwshplaces.readthedocs.io/en/latest/?badge=latest)\n\n[psgallery-img]:   https://img.shields.io/powershellgallery/dt/pwshPlaces?label=Powershell%20Gallery\u0026logo=powershell\n[psgallery-site]:  https://www.powershellgallery.com/packages/pwshPlaces\n[psgallery-v1]:    https://www.powershellgallery.com/packages/pwshPlaces/0.8.1\n[license-badge]:   https://img.shields.io/github/license/techthoughts2/pwshPlaces\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"docs/assets/pwshPlaces.png\" alt=\"pwshPlaces Logo\" \u003e\n\u003c/p\u003e\n\nBranch | Windows - PowerShell | Windows - pwsh | Linux | MacOS\n--- | --- | --- | --- | --- |\nmain | [![Build Status Windows PowerShell main](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows.yml/badge.svg?branch=main)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows.yml) | [![Build Status Windows pwsh main](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows_Core.yml/badge.svg?branch=main)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows_Core.yml) | [![Build Status Linux main](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Linux.yml/badge.svg?branch=main)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Linux.yml) | [![Build Status MacOS main](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_MacOS.yml/badge.svg?branch=main)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_MacOS.yml)\nEnhancements | [![Build Status Windows PowerShell Enhancements](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows.yml/badge.svg?branch=Enhancements)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows.yml) | [![Build Status Windows pwsh Enhancements](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows_Core.yml/badge.svg?branch=Enhancements)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Windows_Core.yml) | [![Build Status Linux Enhancements](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Linux.yml/badge.svg?branch=Enhancements)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_Linux.yml) | [![Build Status MacOS Enhancements](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_MacOS.yml/badge.svg?branch=Enhancements)](https://github.com/techthoughts2/pwshPlaces/actions/workflows/wf_MacOS.yml)\n\n## Synopsis\n\npwshPlaces is a PowerShell module that integrates with leading mapping services like Google Maps and Bing Maps. Offering a suite of commands for interacting with maps, it enables you to perform searches, read reviews, and retrieve detailed information about locations worldwide. From discovering nearby restaurants to geocoding addresses, pwshPlaces equips you with a wealth of geographical data, accessible through simple and intuitive PowerShell commands.\n\n## Description\n\npwshPlaces enables you to leverage the Google Maps and/or Bing Maps APIs to perform a variety of map-related tasks using PowerShell. This module simplifies accessing and analyzing geographical data with user-friendly commands, empowering users to search for locations, read reviews, and perform geocoding effortlessly. Ideal for discovery, travel planning, or enhancing automation scripts, pwshPlaces transforms complex mapping data into actionable insights using PowerShell.\n\n### Features\n\n- Support for both Bing Maps and Google Maps\n- *Find Places with Ease*: Use commands to locate any place, from restaurants to landmarks, using simple queries.\n- *Open-Text Search Capabilities*: Harness the power of flexible, text-based searches. Whether it’s \"coffee shops in Amsterdam\" or \"art galleries in New York\", get targeted results swiftly.\n- *Discover Nearby Points of Interest*: Explore what's around you, be it parks, eateries, or museums, based on your current or specified location.\n- *Efficient Geocoding and Reverse Geocoding*: Convert addresses to coordinates and vice versa, integrating geographical context into your data.\n- *In-depth Place Details*: Dive deeper into specific locations to access comprehensive information like contact details, ratings, reviews, and more.\n- *Time Zone Information*: Stay informed about the time zones of different places, making scheduling and planning across time zones simpler.\n- *Rapid Comparison and Decision Making*: Compare ratings, prices, and other key information quickly and make informed decisions without wading through dense web pages.\n- *Customizable Search Parameters*: Tailor your searches with various parameters like radius, price level, and types to get precisely what you're looking for.\n\n## Getting Started\n\n### Documentation\n\nDocumentation for pwshPlaces is available at: [https://pwshPlaces.readthedocs.io](https://pwshPlaces.readthedocs.io)\n\n### Prerequisites\n\nTo use pwshPlaces you will require a Google Maps or Bing Maps API key. To use all of the functions you will require both.\n\n\u003e 🙄 Not another module that requires an API Key!\n\nBoth 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:\n\n- [How to get a Google Maps API Key](docs/GoogleMapsAPI.md#how-to-get-a-google-maps-api-key)\n- [How to get a Bing Maps API Key](docs/BingMapsAPI.md#how-to-get-a-bing-maps-api-key)\n\n### Installation\n\n```powershell\nInstall-Module -Name 'pwshPlaces' -Repository PSGallery -Scope CurrentUser\n```\n\n## Quick start\n\n```powershell\n######################################################################################\n# Google Maps\n$googleAPIKey = 'yourGoogleAPIKey'\n######################################################################################\n# I want to find a specific place\nFind-GMapPlace -Query \"Krause's cafe\" -GoogleAPIKey $googleAPIKey\nFind-GMapPlace -Query '+18306252807' -GoogleAPIKey $googleAPIKey\nFind-GMapPlace -Query 'cafe' -PointLatitude '29.7049806' -PointLongitude '-98.068343' -GoogleAPIKey $googleAPIKey\n#-------------------------------------------------------------------------------------\n# I want to search for a type of place\nSearch-GMapText -Query \"Cupcakes\" -Type bakery -AllSearchResults -GoogleAPIKey $googleAPIKey\nSearch-GMapText -Query \"italian restaurants in New York\" -MinPrice 4 -GoogleAPIKey $googleAPIKey\n#-------------------------------------------------------------------------------------\n# I want to search for nearby places\nSearch-GMapNearbyPlace -Latitude '29.7049806' -Longitude '-98.068343' -Radius 5000 -GoogleAPIKey $googleAPIKey\nSearch-GMapNearbyPlace -Latitude '29.7049806' -Longitude '-98.068343' -Radius 10000 -RankByProminence -Keyword 'butcher' -Type store -GoogleAPIKey $googleAPIKey\n#-------------------------------------------------------------------------------------\n# I want to get very detailed information about a place - place ID retrieved from other commands\nGet-GMapPlaceDetail -PlaceID 'ChIJf9Yxhme9XIYRkXo-Bl62Q10' -Contact -Atmosphere -GoogleAPIKey $googleAPIKey\n#-------------------------------------------------------------------------------------\n# I want to GeoCode an address\nInvoke-GMapGeoCode -Address '148 S Castell Ave, New Braunfels, TX 78130, United States' -GoogleAPIKey $googleAPIKey\n#-------------------------------------------------------------------------------------\n# I want to reverse GeoCode a location\nInvoke-GMapGeoCode -Latitude '29.7012853' -Longitude '-98.1250235' -GoogleAPIKey $googleAPIKey\n######################################################################################\n# Bing Maps\n$bingAPIKey = 'yourBingAPIKey'\n######################################################################################\n# I want to find a specific place\nFind-BingPlace -Query \"Krause's cafe\" -BingMapsAPIKey $bingAPIKey\nFind-BingPlace -Query 'cafe' -PointLatitude '29.7049806' -PointLongitude '-98.068343' -BingMapsAPIKey $bingAPIKey\n#-------------------------------------------------------------------------------------\n# I want to search for nearby places\nSearch-BingNearbyPlace -Type Attractions -BingMapsAPIKey $bingAPIKey\nSearch-BingNearbyPlace -Type CafeRestaurants -PointLatitude '29.7049806' -PointLongitude '-98.068343' -BingMapsAPIKey $bingAPIKey\n#-------------------------------------------------------------------------------------\n# I want to GeoCode an address\nInvoke-BingGeoCode -AddressLine '148 S Castell Ave' -City 'New Braunfels' -State TX -PostalCode 78130 -BingMapsAPIKey $bingAPIKey\n#-------------------------------------------------------------------------------------\n# I want to reverse GeoCode a location\nInvoke-BingGeoCode -Latitude '29.7030' -Longitude '-98.1245' -BingMapsAPIKey $bingAPIKey\n#-------------------------------------------------------------------------------------\n# I want to determine the Time Zone of a specific place\nFind-BingTimeZone -Query 'New Braunfels, TX' -BingMapsAPIKey $bingAPIKey\nFind-BingTimeZone -PointLatitude 29.70 -PointLongitude -98.11 -BingMapsAPIKey $bingAPIKey\n#-------------------------------------------------------------------------------------\n```\n\n## Notes\n\nThis PowerShell project was created with [Catesta](https://github.com/techthoughts2/Catesta).\n\n## Contributing\n\nIf you'd like to contribute to pwshPlaces, please see the [contribution guidelines](.github/CONTRIBUTING.md).\n\n## License\n\nThis project is [licensed under the MIT License](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechthoughts2%2Fpwshplaces","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechthoughts2%2Fpwshplaces","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechthoughts2%2Fpwshplaces/lists"}