# Google Maps Platform

Google Maps Platform convierte direcciones en coordenadas, busca lugares y planifica rutas. Conéctelo y las direcciones de sus <Term id="table">tablas</Term> se pueden poner en un mapa o unir por ubicación con sus otros datos.

La IA de su <Term id="studio">Studio</Term> prepara la conexión; usted la termina pegando una clave de API de su propio proyecto de Google Cloud.

## Antes de empezar [#antes-de-empezar]

- Un <Term id="project">proyecto</Term>. La IA de su Studio hace el trabajo. Consulte [Crear un proyecto](/docs/es/projects/create-a-project).
- Un proyecto de Google Cloud con facturación configurada y las API de Maps que necesita activadas (por ejemplo geocodificación, lugares o rutas).
- Una **clave de API** de ese proyecto. Restrinja la clave a esas API, para que no se pueda usar para nada más.
- Una tabla con direcciones, si quiere geocodificarlas. Las direcciones limpias y completas (calle, ciudad, país) dan mejores resultados.

<Callout type="info" title="Google cobra el uso">
  Las solicitudes hechas con su clave son uso de Google Maps Platform en su propia cuenta de Google, y las cobra Google, no Klarety. Revise los precios de Google antes de empezar. Pídale a la IA que geocodifique cada dirección una sola vez y guarde el resultado, en lugar de llamar a Google cada vez.
</Callout>

## Conéctelo [#conéctelo]

<Steps>
<Step>
### Abra Google Maps Platform [#abra-google-maps-platform]
Vaya a <AppLink to="connectors" />, busque **Google Maps Platform** y ábralo.
</Step>
<Step>
### Envíe la solicitud a la IA de un proyecto [#envíe-la-solicitud-a-la-ia-de-un-proyecto]
En **Conéctelo con la IA de su Studio**, elija el **Proyecto** que usará Google Maps Platform. **Lo que se le pide a la IA** empieza con una solicitud para conectar Google Maps Platform a este proyecto para que pueda geocodificar direcciones y obtener lugares y rutas. Edítela para que diga exactamente lo que necesita, por ejemplo: "Geocodifique la columna direccion de la tabla clientes y agregue columnas de latitud y longitud". Luego seleccione **Enviar a la IA**.

La IA empieza de inmediato si el Studio está abierto, o cuando se abra. Seleccione **Abrir Studio** para ir allí.

<Screenshot src="/docs/_media/connect-data-with-ai-in-dashboard-data-page.png" alt="Conectar Google Maps Platform con la IA de un proyecto desde la página de Conectores" />
</Step>
<Step>
### Termine la conexión [#termine-la-conexión]
La IA prepara la conexión y nunca le pide una clave en el chat. El borrador aparece como **Esperando su respuesta**. Seleccione **Conectar** para abrir el diálogo de conexión de Google Maps Platform.

El diálogo enumera los pasos para obtener la clave y tiene un enlace que abre la página de su clave en Google Cloud en una pestaña nueva. Copie allí la clave y péguela en **Clave**. El diálogo muestra el único sitio al que se envía la clave.
</Step>
<Step>
### Elija qué puede hacer la IA [#elija-qué-puede-hacer-la-ia]
En **Qué puede hacer la IA con ello**, elija **Puede leer** (nada cambia) o **Puede leer y modificar** (la IA también puede agregar, modificar y eliminar elementos). Luego seleccione **Conectar**.

<Screenshot src="/docs/_media/slack-connector-how-to-connect-in-ui.png" alt="El diálogo de conexión de Google Maps Platform con la elección de acceso" />
</Step>
<Step>
### Pruébela y avise a la IA [#pruébela-y-avise-a-la-ia]
El diálogo indica que Google Maps Platform está conectado. Seleccione **Probar** y luego **Avisar a la IA** para que continúe.
</Step>
</Steps>

También puede empezar desde un proyecto: en **Configuración**, **Claves**, descríbalo en **¿Qué quiere conectar?** y seleccione **Pedir a la IA que conecte**.

Con **Puede leer** es suficiente: buscar coordenadas, lugares y rutas no cambia nada en su cuenta de Google.

## Lo que obtiene [#lo-que-obtiene]

- **Coordenadas en sus tablas.** Las direcciones geocodificadas se guardan como columnas en <Term id="nexus">Nexus</Term>, así que solo le paga a Google una vez por dirección.
- **Mapas y uniones por ubicación.** Ponga filas en un mapa dentro de una aplicación, o únalas con otros datos por lugar: la tienda más cercana, los clientes dentro de una región, las entregas por zona.
- **Lugares y rutas.** Una aplicación o un <Term id="agent">agente</Term> puede consultar los detalles de un lugar o planificar una ruta entre puntos mientras se ejecuta.

## Probar, pausar y reconectar [#probar-pausar-y-reconectar]

Las conexiones de un proyecto aparecen en su **Configuración**, en **Claves**, con su estado.

<Screenshot src="/docs/_media/manage-connections-by-toggle-on-off-per-project.png" alt="Las conexiones de un proyecto en Configuración, Claves" />

| Estado | Qué significa |
| --- | --- |
| **Esperando su respuesta** | La preparó la IA. Seleccione **Conectar** para terminarla. |
| **Funciona** | Conectada y lista para el proyecto. |
| **Requiere reconexión** | La clave o el inicio de sesión dejó de funcionar. Seleccione **Reconectar**. |
| **En pausa** | Nadie puede usarla hasta que seleccione **Reanudar**. |

Desde la misma fila: **Probar**, **Pausar**, **Desactivar aquí** (este proyecto deja de usarla) o **Quitar** (elimina la clave y todos los Studios que la usan dejan de acceder a Google Maps Platform).

Una conexión pertenece al proyecto donde se creó. Propietarios y administradores las ven todas en **Sus conexiones**, en <AppLink to="connectors" />. Sigue desactivada para otros proyectos hasta que un administrador la active en la lista de proyectos que pueden usarla.

## Si la prueba falla [#si-la-prueba-falla]

**Probar** indica uno de estos resultados:

- Funciona: el proyecto llegó al servicio.
- La clave fue rechazada: seleccione **Reconectar** e ingrese una nueva.
- No se puede acceder al servicio: revise que esté disponible y acepte conexiones externas, y pruebe de nuevo.
- Internet está desactivado: el internet del proyecto está **Desactivado**. Actívelo en su **Configuración**. Con **Solo permitidos**, el Studio solo llega a sus conexiones y a los sitios que usted agregue.
- Aún no está conectada: seleccione **Conectar**.

Propios de Google Maps Platform:

- **Se rechaza la clave.** La API que necesita no está activada en el proyecto de Google Cloud, o las restricciones de la clave no la incluyen. Corríjalo en Google Cloud y pruebe de nuevo.
- **Algunas direcciones no tienen coordenadas.** La dirección estaba incompleta o era ambigua. Pídale a la IA que liste las filas que no pudo geocodificar para que usted las corrija.

## A dónde va su clave [#a-dónde-va-su-clave]

La clave o el inicio de sesión se cifra con un servicio de claves administrado en cuanto selecciona **Conectar**, y ni siquiera la IA puede leerlo. El Studio nunca tiene la clave. Si el único sitio al que se envía no es la dirección propia del servicio, Klarety se lo advierte y le pide escribir el sitio para confirmar.

## Siguientes pasos [#siguientes-pasos]

- [Google Sheets](/docs/es/connectors/google-sheets)
- [Tablas](/docs/es/data/tables)
- [Todos los conectores](/docs/es/connectors/catalog)