> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Captura direcciones con Google Maps

> Conecta tu propia clave de Google Maps para que el checkout sugiera direcciones y guarde las coordenadas exactas de entrega.

Con una clave de Google Maps, el campo **Dirección** del checkout sugiere direcciones mientras el comprador escribe y muestra un mapa donde confirma el punto exacto de entrega. Las coordenadas se guardan en el pedido y en las direcciones de la cuenta del comprador.

Sin clave, el checkout usa el formulario manual. El comprador escribe su dirección y busca su distrito.

La configuras en **[Configuración → Envío → Geolocalización](https://app.riqra.com/settings/shipping/geolocation)**. La clave es tuya y el consumo se factura a tu cuenta de Google.

## Obtén la clave

<Steps>
  <Step title="Crea un proyecto en Google Cloud">
    Crea un proyecto en [Google Cloud](https://console.cloud.google.com/), o reutiliza uno, y activa la facturación.
  </Step>

  <Step title="Habilita tres APIs">
    Habilita exactamente **Maps JavaScript API**, **Places API (New)** y **Geocoding API**.
  </Step>

  <Step title="Crea una clave de API y restríngela">
    * **Restricción de aplicación**: sitios web con referentes HTTP. Agrega los dominios de tu tienda. La página de **Geolocalización** los lista con el formato `https://tu-tienda.com/*`, listos para copiar.
    * **Restricción de API**: solo las tres APIs del paso anterior.
    * **Cuotas diarias**: pon un límite diario a cada API. Acota el costo si alguien abusa de tu clave.
  </Step>

  <Step title="Pega la clave y guarda">
    En **Clave de API de Google Maps**, pega la clave y haz clic en **Guardar**. La sección muestra **Activa**.
  </Step>
</Steps>

La clave es pública por diseño. Viaja en el código de tu tienda y su protección son las restricciones que configuras en Google Cloud.

## Modo de captura

| Modo | Qué ve el comprador |
| - | - |
| **Mapa con pin y autocompletado** | Sugerencias de Google al escribir la dirección y un mapa con un pin fijo. Mueve el mapa para dejar el pin en el punto exacto. |
| **Automático, sin mapa** | Un campo de texto simple, sin sugerencias ni mapa. Al confirmar el pedido, la dirección escrita se geocodifica y se guardan las coordenadas que Google devuelve, sin confirmación del comprador. |

## Qué ve el comprador con el mapa

* Al escribir tres letras, ve sugerencias de Google limitadas a tu país. Al elegir una, la dirección se completa, el distrito se completa cuando hay una coincidencia clara y aparece el mapa con el pin.
* **Usar mi ubicación** usa la ubicación del navegador para centrar el mapa y completar la dirección.
* **Ubicar en el mapa** aparece cuando escribió una dirección que no está en las sugerencias. Ubica el texto en el mapa para que ajuste el pin.
* Mover el mapa cambia solo las coordenadas. Nunca reescribe lo que el comprador escribió.

El comprador siempre puede completar el pedido sin pin. La dirección escrita y el distrito son suficientes, y el distrito sigue definiendo la zona y el costo de envío.

Si Google no responde, el checkout muestra el formulario manual.

## En el pedido

Cuando el pedido tiene coordenadas, el panel **Entrega** del pedido muestra el enlace **Ver en Google Maps**.

## Desactiva la geolocalización

Borra la clave y haz clic en **Guardar**. El checkout vuelve al formulario manual. Las coordenadas ya guardadas se conservan.
