Your location
Turn on Share location (desktop: Settings → General; iPhone and iPad: Settings) to let bots answer questions such as "coffee near me". It is off until you turn it on, and each device has its own switch. The first time, the system asks for permission.
On a Mac, OpenTeam uses macOS Location Services. If access is denied, choose Open System Settings, turn on Location Services and allow OpenTeam, then try Share location again. The switch stays off until OpenTeam gets a location. If it cannot get a location, try again later.
While it is on, each message you send from that device includes the device's current location. The server keeps only the newest one, from whichever device sent the latest message, and a bot reads it when it needs to know where you are. It can then search for places near that point. The location is not added to the message text. A computer's location usually comes from Wi-Fi and is less precise than a phone's GPS, and the bot is told how old and how precise the location is. Turning the switch off on any device deletes the saved location.
OpenStreetMap
Choose Add, then Connect. No account or API key is needed. Bots can search for an address or landmark, find nearby places, and request walking, cycling, or driving routes through 2–10 stops.
Search uses Photon and Nominatim; routes use Valhalla. OpenStreetMap can supply hours, websites, and phone numbers, but has no ratings, reviews, or business photos. Calculated open-now status uses posted hours and the time zone supplied by the bot; it does not account for public holidays, and is omitted for missing or unsupported hours.
These community services have no uptime guarantee. The plugin caches results for ten minutes and spaces Nominatim requests at least 1.1 seconds apart. Busy services can return an error; ask the bot to retry later rather than treating an empty result as proof that no place exists. See the OpenStreetMap plugin guide.
Google Maps
- Choose a Google Cloud project with billing enabled.
- Enable Places API (New) and Routes API.
- Create an API key restricted to those APIs.
- Add Google Maps in Marketplace, paste the key into its account settings, and choose Connect.
Bots can search for places, get nearby results, read place details, check the key, and request walking, cycling, or driving routes through 2–25 stops. Results can include Google ratings and review counts, a photo, price level, and current opening status. Place details can include up to five reviews selected by Google.
Google bills requests against your project after any applicable allowance. Photos require separate requests, and richer place fields can use higher billing tiers. Check the project's quotas and billing controls before use; consult the Google Maps plugin guide for the API fields and pricing link. Identical requests are reused for five minutes. Photo links can expire, so an older card may show a placeholder.
Privacy and map display
Your shared location stays on your OpenTeam server. When a bot uses it, the coordinates reach your model provider and any places service the bot searches with.
OpenStreetMap search sends place names and queries to Photon and Nominatim; routes send stop coordinates to Valhalla. Google Maps sends queries, search areas, and route stops to Google with your API key. The key stays on your server and is not shown to bots.
Displaying a map makes additional requests from the client: desktop uses OpenFreeMap tiles and fonts, while iPhone and iPad use Apple's MapKit. Place photos load through the selected OpenTeam server's authenticated image endpoint. The server fetches only public HTTPS destinations, validates redirects and DNS answers, and does not forward your OpenTeam credentials to the image host. Private destinations and unsupported or oversized images show a placeholder. Map tiles and fonts still use the client display services above. These display services are separate from the plugin that found the place. As with other tool results, place information used in a task can also reach your model provider. See privacy and connected services.