Guía: Cómo Obtener Nombres de "Lugares Desconocidos" con una API Key

¿Cansado de ver "Lugar Desconocido"? Te guiamos paso a paso para crear una API Key de Google Cloud y usar la herramienta "Obtener Nombres" para completar tu historial.

Símbolos de API y Nube

¿Por qué Ocurre Esto?

Como explicamos en nuestro primer artículo, tu archivo Rutes.json a menudo solo incluye el placeId (un código) en lugar del nombre del lugar (ej. "Starbucks"). Esto ahorra espacio, pero deja tu historial incompleto.

Para "rellenar" estos nombres, necesitamos preguntarle a Google: "Oye, ¿qué nombre le corresponde a este ID?". Esta consulta se realiza a través de la API de Google Places. Para usarla, Google requiere que te identifiques con una "API Key" (una llave).

¿Es Gratis? (Sí, Probablemente)

Sí. Google Cloud ofrece un crédito gratuito de **$200 USD cada mes** para sus servicios, incluida la Places API.

La herramienta "Obtener Nombres" (específicamente "Place Details - Basic") cuesta alrededor de $0.017 por solicitud. Esto significa que necesitarías reparar más de **11,700 lugares desconocidos en un solo mes** para agotar tu crédito gratuito. Para un usuario normal, el costo real será de $0.

Guía Rápida: 4 Pasos

Los pasos exactos están en la propia herramienta (botón en la app), pero aquí tienes el resumen:

  1. Crear un Proyecto: Ve a la Consola de Google Cloud, inicia sesión con tu cuenta de Google y crea un "Nuevo Proyecto". Dale el nombre que quieras (ej. "Mi Visor de Mapas").
  2. Habilitar la API: En el buscador de la consola, busca "Places API". Selecciónala y haz clic en "Habilitar".
  3. Activar la Facturación: La API no funcionará (ni siquiera gratis) si no vinculas una cuenta de facturación. Ve a la sección "Facturación" y vincula tu proyecto. Google te pedirá una tarjeta, pero *no te cobrará* mientras estés dentro del crédito gratuito de $200/mes.
  4. Crear la Credencial: Ve a "APIs y Servicios" > "Credenciales". Haz clic en "+ Crear Credenciales" y selecciona "Clave de API". ¡Listo! Copia esa clave.

Usando la Herramienta en el Visor

Una vez que tengas tu clave (empezará con `AIza...`), el proceso en nuestra app es simple:

  1. Carga tu Rutes.json como de costumbre.
  2. Haz clic en el botón lateral ("Obtener Nombres").
  3. Haz clic en "Empezar Escaneo". La app te dirá cuántos lugares desconocidos encontró.
  4. Pega tu API Key en el campo de texto.
  5. Haz clic en "Iniciar Proceso".

La herramienta consultará a Google por cada ID y, al terminar, te permitirá descargar un **nuevo archivo `Rutes_con_nombres.json`**. También te preguntará si quieres recargar la app con esos nuevos datos. ¡Di que sí y disfruta de tu historial completo!