Google Maps Platform
Geocode addresses and get places and routes for your data.
Google Maps Platform turns addresses into coordinates, looks up places and plans routes. Connect it and the addresses in your can go on a map or be joined by location with your other data.
Your 's AI prepares the connection; you finish it by pasting an API key from your own Google Cloud project.
Before you start
- A . Its Studio's AI does the work. See Create a project.
- A Google Cloud project with billing set up and the Maps APIs you need turned on (for example geocoding, places or routes).
- An API key from that project. Restrict the key to just those APIs, so it cannot be used for anything else.
- A table with addresses, if you want to geocode them. Clean, complete addresses (street, city, country) give better results.
Usage is billed by Google
Requests made with your key are Google Maps Platform usage under your own Google account, billed by Google, not by Klarety. Check Google's pricing before you start. Ask the AI to geocode each address once and store the result, rather than calling Google every time.
Connect it
Open Google Maps Platform
Go to Connectors, search for Google Maps Platform and open it.
Send the request to a project's AI
Under Connect it with your Studio's AI, choose the Project that should use Google Maps Platform. What the AI is asked starts as "Connect Google Maps Platform to this project so it can geocode addresses and get places and routes." Edit it to say exactly what you want, for example: "Geocode the address column of the customers table and add latitude and longitude columns". Then select Send to AI.
The AI starts at once if the Studio is open, or when it next opens. Select Open Studio to go there.
Finish the connection
The AI drafts the connection and never asks for a key in the chat. The draft shows as Waiting for you. Select Connect to open the Connect Google Maps Platform dialog.
The dialog lists the steps to get the key and has Open the page with your key, which opens Google Cloud in a new tab. Copy the key there and paste it into Key. The dialog shows the only site the key is ever sent to.
Choose what the AI may do
Under What the AI may do with it, choose Can read (nothing there changes) or Can read and change (the AI may also add, change and remove things). Then select Connect.
Test it and tell the AI
The dialog says Google Maps Platform is connected. Select Test it, then Tell the AI so it carries on.
You can also start inside a project: in Settings, Keys, describe it in What do you want to connect? and select Ask AI to connect.
Can read is enough here: looking up coordinates, places and routes does not change anything in your Google account.
What you get
- Coordinates in your tables. Geocoded addresses are stored as columns in , so you pay Google once per address.
- Maps and joins by location. Put rows on a map in an app, or join them with other data by place: nearest store, customers inside a region, deliveries per area.
- Places and routes. An app or an can look up a place's details or plan a route between points while it runs.
Test, pause and reconnect
A project's connections are listed in its Settings, under Keys, with their status.
| Status | What it means |
|---|---|
| Waiting for you | Drafted by the AI. Select Connect to finish it. |
| Works | Connected and usable by the project. |
| Needs reconnecting | The key or sign-in stopped working. Select Reconnect. |
| Paused | Nobody can use it until you select Resume. |
From the same row: Test, Pause, Turn off here (this project stops using it) or Remove (deletes the key, and every Studio using it stops reaching Google Maps Platform).
A connection belongs to the project it was made in. Owners and admins see all of them under Your connections on Connectors. It stays off for other projects until an admin switches it on under Projects that may use it.
If the test fails
Test reports one of these:
- It works: the project reached the service.
- The key was rejected: select Reconnect and enter a new one.
- The service cannot be reached: check that it is up and accepts outside connections, then test again.
- Internet is off: the project's internet is Off. Turn it on in its Settings. With Only allowed, the Studio reaches only its connections and the sites you add.
- It is not connected yet: select Connect.
Specific to Google Maps Platform:
- The key is refused. The API you need is not turned on in the Google Cloud project, or the key's restrictions do not include it. Fix it in Google Cloud and test again.
- Some addresses have no coordinates. The address was incomplete or ambiguous. Ask the AI to list the rows it could not geocode so you can correct them.
Where your key goes
The key or sign-in is encrypted with a managed key service the moment you select Connect, and not even the AI can read it. The Studio never holds the key. If the one site it is sent to is not the service's own address, Klarety warns you and asks you to type the site to confirm.