/ README.md
README.md
 1  # maps
 2  
 3  In a nutshell, this [prototype] (!) Android-only app is just an interface to Google's Places
 4  API, specifically the [Text Search (New)] endpoint.
 5  
 6  [prototype]: #prototype
 7  [Text Search (New)]: https://developers.google.com/maps/documentation/places/web-service/text-search
 8  
 9  [![Screenshot of the app with the query "bar near cowley rd cambridge open 2am" and two of that query's results, the castle bar and revolution cambridge](.screenshot.webp)](.screenshot.webp)
10  
11  Search for places using natural language, then tap one of the icons on the right
12  of a search result. The left icon is Copy. Tapping it puts the place's
13  coordinates in your clipboard for pasting into a calendar event, sending to a
14  friend, etc. The right icon is Open. Tapping it opens the coordinates in any
15  installed app that knows how to handle `geo:` [Intent URIs]. That includes e.g.
16  [Organic Maps], [OsmAnd], Google Maps, Waze, and more.
17  
18  [Intent URIs]: https://developers.google.com/maps/documentation/urls/android-intents#display-a-map
19  [Organic Maps]: https://organicmaps.app
20  [OsmAnd]: https://osmand.net
21  
22  <details><summary>Click to expand a GIF showing the app in use</summary>
23  
24  [![Screen recording showing the app open the top result in Organic Maps](.recording.gif)](.recording.gif)
25  
26  </details>
27  
28  # Prototype
29  This app is a prototype. If people like it, we may extend it with a server-side
30  component that hides all PII (e.g. IP addresses) from Google for a small monthly
31  fee. For now, however, the prototype is [free to test] and will install as
32  "Maps+" in your launcher until we come up with a better name (suggestions
33  welcome!).
34  
35  [free to test]: https://secluded.site/alpha.apk