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 la cuota
4. Actualiza tu código
5. Supervisa el tráfico de tu ID de cliente
6. Cómo detener tu ID de cliente
7. Reactivación temporal del autoservicio del ID de cliente

Verifica el uso actual del ID de cliente

Antes de comenzar el proceso de migración, enumera lo siguiente:

• Servicios de Maps Platform que usas con tu ID de cliente.
• Son las aplicaciones, los sitios o los sistemas con los que usas tu ID de cliente.

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

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

Para obtener una lista de los servicios de Maps Platform, consulta lo siguiente:

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

Para sugerencias de aplicaciones, sitios o sistemas:

La consola de Cloud no muestra detalles de tus aplicaciones, sitios ni sistemas. Sin embargo, puedes encontrar algunos indicios de las fuentes de tráfico de tu 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 los siguientes parámetros de 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 a un proyecto de Google Cloud, y usar una clave de API de ese proyecto te dará acceso a las mismas funciones a las que accedías antes con tu ID de cliente. Te recomendamos que migres al proyecto asociado para evitar problemas con las cuotas o la falta de funciones.

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 nueva clave de API 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, aplicación 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 aplicaciones para tu clave de API (p.ej., sitios web, direcciones IP, apps para Android o apps para iOS).
• Establece restricciones de API para tu clave de API.

Para obtener más información, consulta la orientación sobre seguridad en 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 los sitios de referencia de confianza de tu ID de cliente a las restricciones de la clave de API. Puedes encontrar la lista de remitentes de confianza en la consola de Cloud.

Revisa la configuración de las cuotas

Asegúrate de tener la configuración de cuota 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 tu cuota en la página Cuotas de Google Maps.

Más información sobre los informes de cuota

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

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

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

1. Verifica si estás usando 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 los siguientes parámetros de 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 tienes que preocuparte por la configuración de la cuota, 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 el nivel de detalle por segundo y por día.
  • Gráfico de solicitudes 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 que se necesita.
• 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 del cliente por el parámetro 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 del canal para generar informes

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

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

Se quita el parámetro de firma para los servicios web

Para las siguientes APIs de servicio web, no se necesita el parámetro de firma cuando se accede 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

Las APIs de Maps Static y Street View Static aún requieren el parámetro de firma. Aceptan una pequeña cantidad de solicitudes sin firma para realizar pruebas, pero comienzan a fallar una vez que se alcanza el umbral en tu producción. Reemplaza el secreto de firma del ID de cliente por el de la clave de API. Puedes usar el mismo algoritmo de firma, pero debes usar otro secreto de firma. 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 el formato "project_number:123456" en el panel cuando se usa la agrupación por credencial.

Cómo detener tu ID de cliente

Recomendamos que los desarrolladores pausen 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 cualquier uso restante de tu ID de cliente no sea crítico (p.ej., pruebas, cachés, bots, etcétera) y pueda devolver errores sin causar un impacto en el negocio. Puedes pausar 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 del autoservicio del ID de cliente

Dado que los IDs de cliente de Google Maps Platform entraron en el período de baja gradual 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 pocas horas, puedes optar por reactivar el acceso de forma manual si se requiere un restablecimiento inmediato.

Para restablecer el acceso de forma urgente, 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.
• Busca el 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 quedar exento temporalmente de más interrupciones, comunícate con el equipo de asistencia de Google Maps Platform y proporciona los siguientes detalles:

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

Informe de uso del ID de cliente (en Informes de facturación)

Consultar 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, muestran información detallada sobre el uso y los costos de más de 30 días.

Para supervisar el uso del ID de cliente a través de la consola de Google Cloud, sigue 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 facturación secundaria deseada.
3. Agrupa los datos del informe según la clave de la 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 completa para las solicitudes del 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 ver si nuestra solicitud falla o no?

Puedes consultar tus 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.

RefererNotAllowedMapError error

Verás el error RefererNotAllowedMapError si tu dominio de origen no se agregó 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 tu 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"
}