Guía de migración de IDs de cliente

Descripción general

Para comenzar, sigue estos pasos:

1. Verifica el uso actual del ID de cliente
2. Prepara las claves de API
3. Revisa la configuración de cuotas
4. Actualiza tu código
5. Supervisa el tráfico de tu ID de cliente
6. Pausar tu ID de cliente
7. Reactivación temporal de autoservicio del ID de cliente

Verifica el uso actual del ID de cliente

Antes de comenzar el proceso de migración, haz una lista de lo siguiente:

• Servicios de Maps Platform que usas con tu ID de cliente
• Aplicaciones, sitios o sistemas con los que usas tu ID de cliente

En mayo de 2025, Google envió un correo electrónico de notificación a los clientes afectados sobre la baja del ID de cliente. También puedes encontrar esta información en el correo electrónico de notificación.

En la consola de Cloud, puedes verificar el estado más reciente del uso de tu ID de cliente en la página de métricas de Google Maps.

Para obtener una lista de los servicios de Maps Platform:

1. Abre la página Métricas en la consola de Cloud.
2. Filtra tu uso con la siguiente configuración:
   • Credenciales: Selecciona solo "project_number:<identificador numérico>".
3. Establece el siguiente filtro:
   • Agrupado por: API

Para obtener sugerencias sobre aplicaciones, sitios o sistemas:

La consola de Cloud no muestra detalles de tus aplicaciones, sitios o sistemas. Sin embargo, puedes encontrar algunas sugerencias sobre las fuentes de tu tráfico de ID de cliente. Para ello, sigue estos pasos:

1. Abre la página Métricas en la consola de Cloud.
2. Selecciona un servicio de Maps Platform en el menú desplegable.
3. Filtra tu uso con la siguiente configuración:
   • Credenciales: Selecciona solo "project_number:<identificador numérico>".
4. Establece el siguiente filtro:
   • Agrupar por: Plataforma o Dominio
5. Repite el paso 2 para cada servicio de Maps Platform para el que necesites verificar el tráfico.

Prepara las claves de API

Todos los IDs de cliente están asociados con un proyecto de Google Cloud, y el uso de una clave de API de ese proyecto te dará acceso a las mismas funciones a las que accedías anteriormente con tu ID de cliente. Te recomendamos que migres al proyecto asociado para evitar problemas con las cuotas o las funciones faltantes.

1. Busca el proyecto de Cloud al que está vinculado tu ID de cliente:
   • Preguntas frecuentes sobre la migración del portal
2. Asegúrate de que tu proyecto de Cloud esté vinculado a una cuenta de facturación abierta.
3. Crea una clave de API nueva para la migración del ID de cliente.
   • Puedes reutilizar cualquier clave de API existente en el proyecto de Cloud.
   • Puedes usar varias claves de API del mismo proyecto de Cloud, por ejemplo, para separar el tráfico de cada servicio de Maps Platform o para separar el tráfico de diferentes plataformas (navegador, app para dispositivos móviles, etcétera). Consulta la guía de seguridad para conocer las prácticas recomendadas sobre la administración de claves de API.

Protege tu clave de API

Asegúrate de proteger tu clave de API para evitar el acceso no autorizado.

• Establece una restricción de aplicación para tu clave de API (p.ej., sitios web, direcciones IP o apps para Android o iOS).
• Establece restricciones de API para tu clave de API.

Para obtener más detalles, consulta la guía de seguridad de Google Maps Platform.

En el caso de la API de Maps JavaScript, la API de Maps Static y la API de Street View Static, puedes migrar las URLs de referencia de confianza en tu ID de cliente a las restricciones de la clave de API. Puedes encontrar la lista de URLs de referencia de confianza en la consola de Cloud.

Revisa la configuración de cuotas

Asegúrate de tener la configuración de cuotas esperada en tu proyecto de Cloud. Solo debes hacerlo si llamas a los servicios del cliente de la API de Maps JavaScript desde un ID de cliente. Puedes verificar y ajustar la configuración de cuotas en la página de cuotas de Google Maps.

Más información sobre los informes de cuotas

Aumento de cuotas para los servicios del cliente de la API de Maps JavaScript

Si usas los siguientes servicios en la API de Maps JavaScript, verás que aumenta el uso de la cuota después de la migración de la clave de API.

Revisa tu configuración de cuotas actual y el uso actual, y ajusta los límites de cuota según corresponda.

1. Verifica si usas los servicios del cliente de la API de Maps JavaScript con un ID de cliente.
   • Abre la página Métricas en la consola de Cloud.
   • Filtra tu uso con la siguiente configuración:
     • Agrupado por: Método de API
     • Credenciales: Selecciona solo "project_number:<identificador numérico>".
   • Luego, verás una lista de nombres de métodos con su tráfico en el gráfico "Tráfico por método de API".

• Si no usas esos métodos de la API, no debes preocuparte por la configuración de cuotas, ya que el tráfico de tu ID de cliente ya consume la cuota de tu proyecto.
• Estima el uso de la cuota de tu ID de cliente.
  • Para cada uno de los servicios, verifica la granularidad por segundo y por día.
  • Gráfico por segundo: Multiplica el tráfico máximo por 60 para obtener las necesidades adicionales de cuota por minuto.
  • Gráfico por día: El tráfico máximo debe ser la cuota adicional por día.
• Ajusta tu cuota en los servicios de Maps Platform correspondientes.
  • Según el nombre del método que encuentres en el paso 1, ajusta la cuota en los servicios correspondientes.

Actualiza tu código

Reemplaza el parámetro de cliente por el parámetro de clave

Actualiza las credenciales de autenticación de URL&client={value} a URL&key={value} en tus llamadas salientes a la API de GMP. Si tus apps usan HTTP para acceder a los servicios de GMP, actualízalas para que usen HTTPS.

Actualiza el parámetro de canal para los informes

Puedes hacer un seguimiento de tu uso por canales si especificas el parámetro de canal en tus solicitudes a la API. Las claves de API solo admiten valores numéricos para el parámetro de canal. Si usas tu ID de cliente con valores no numéricos para el parámetro de canal, actualízalo a un valor numérico admitido.

Consulta los informes de Google Maps Platform para obtener más información.

Quita el parámetro de firma para los servicios web

Para las siguientes APIs de servicios web, no se necesita el parámetro de firma cuando accedes a ellas con una clave de API. Solo quita el parámetro de firma de tus solicitudes a la API.

• API de Directions (heredada)
• API de Distance Matrix (heredada)
• API de Geocoding
• API de Elevation
• API de Time Zone

Consulta la descripción general del plan Premium para obtener más información.

Firma secreta para las APIs de Imagery

La API de Maps Static y la API de Street View Static aún requieren el parámetro de firma. Aceptan una pequeña cantidad de solicitudes sin firma para fines de prueba, pero comienzan a fallar una vez que alcanzan el umbral en tu producción. Reemplaza tu firma secreta de la del ID de cliente por la de la clave de API. Puedes usar el mismo algoritmo de firma, pero debes usar otra firma secreta. Para obtener más información, consulta Cómo usar una firma digital.

Supervisa el tráfico de tu ID de cliente

Después de la implementación, confirma que tu tráfico se haya migrado correctamente con los paneles de la consola de Cloud. Comenzarás a ver una disminución en el tráfico de tu ID de cliente, que se muestra en formato "project_number:123456" en el panel cuando se agrupa por credencial.

Pausar tu ID de cliente

Recomendamos a los desarrolladores que detengan los IDs de cliente después de la migración. Esto es para proteger tus credenciales de cualquier tráfico no deseado y confirmar que el uso restante en tu ID de cliente no es crítico (p.ej., pruebas, caché, bots, etcétera) y puede mostrar errores sin causar un impacto en la empresa. Puedes detener tu ID de cliente en la consola de Cloud. Consulta la descripción general de la autenticación del plan Premium para obtener más detalles.

Reactivación temporal de autoservicio del ID de cliente

Como los IDs de cliente de Google Maps Platform ingresaron en el período de baja por etapas en mayo de 2026, ya no se garantiza la disponibilidad del servicio. El acceso se restringirá periódicamente como parte del proceso programado de finalización del servicio. Si bien el servicio suele restablecerse automáticamente en unas horas, puedes reactivar el acceso de forma manual si se requiere un restablecimiento inmediato.

Para restablecer el acceso con urgencia, puedes realizar una reactivación de autoservicio a través de la consola de Google Cloud:

• Navega a la página Credenciales de Google Maps Platform.
• Ubica tu proyecto de Cloud específico que está vinculado a tu ID de cliente.
• Haz clic en el ícono de reactivación ubicado en el extremo derecho de la entrada para restablecer el servicio.

Si no puedes migrar rápidamente a las claves de API y deseas estar exento temporalmente de más interrupciones, comunícate con el equipo de asistencia de Google Maps Platform con los siguientes detalles:

• ID de cliente
• Caso de uso específico
• Fecha de migración objetivo
• Evaluación del impacto en la empresa

Informe de uso del ID de cliente: de los informes de facturación

Verificar los informes de facturación en lugar de las métricas del proyecto puede ser útil para los usuarios que no tienen acceso a las métricas del proyecto, por ejemplo, los administradores de facturación (en especial, los socios de Maps Platform). Si bien los informes de facturación tienen una latencia de 1 a 2 días, tienen el beneficio de mostrar más de 30 días de estadísticas de uso y costo.

Puedes supervisar el uso del ID de cliente a través de la consola de Google Cloud siguiendo estos pasos:

1. Navega a la página Facturación > Informes en la consola de Google Cloud.
2. (Opcional, solo para socios) Aplica un filtro para seleccionar la cuenta de subfacturación deseada.
3. Agrupa los datos del informe por la clave de etiqueta goog-maps-api-key-suffix. Esta etiqueta muestra los caracteres finales de una clave de API.
4. Para identificar el tráfico del ID de cliente, busca entradas en las que falte o esté vacía la etiqueta goog-maps-api-key-suffix, ya que esta etiqueta no se propaga para las solicitudes de ID de cliente.
5. Ignora los SKUs que no están destinados a asociarse con solicitudes a la API, por ejemplo, los SKUs de suscripción.

Solución de problemas

¿Cómo podemos saber si nuestra solicitud falla o no?

Puedes consultar las estadísticas de errores en los gráficos de códigos de respuesta.

Error ApiNotActivatedMapError o REQUEST_DENIED

Verás el error ApiNotActivatedMapError o REQUEST_DENIED si no habilitaste el servicio en tu proyecto de Cloud. Sigue las instrucciones para habilitar el servicio.

Error RefererNotAllowedMapError

Verás el error RefererNotAllowedMapError si tu dominio de origen no se agrega a tu clave de API. Consulta la sección "Protege tu clave de API" y agrega tu dominio a la clave de API.

Error OverQuotaMapError o OVER_QUERY_LIMIT

Verás el error OverQuotaMapError o OVER_QUERY_LIMIT si la cuota configurada no es suficiente para cubrir tu tráfico. Consulta la sección "Revisa la configuración de cuotas" y ajusta la cuota según corresponda.

Error "Requests to this API must be over SSL"

Si recibes el siguiente mensaje de error, actualiza tus solicitudes a la API de "http://" a "https://".

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}