Guía de migración de IDs de cliente

Descripción general

Para aumentar la seguridad y la confiabilidad de la autenticación, los IDs de cliente de Maps Platform dejaron de estar disponibles el 26 de mayo de 2025 y ya no se podrán usar después del 31 de mayo de 2026.

En lugar de usar un ID de cliente, debes usar credenciales de clave de API para autenticar el tráfico de tu servicio de la API de Google Maps. En esta guía, se muestra cómo migrar del uso de IDs de cliente al uso de claves de API.

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 las cuotas
4. Actualiza tu código
5. Supervisa el tráfico de tu ID de cliente
6. Cómo detener tu 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.
• 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 consultar 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, haz lo siguiente:

1. Abre la página Métricas en Cloud Console.
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 obtener sugerencias sobre aplicaciones, sitios o sistemas:

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

1. Abre la página Métricas en Cloud Console.
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 accediste anteriormente 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, 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, 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 las URLs de referencia de confianza en tu ID de cliente a las restricciones de la clave de API. Puedes encontrar la lista de sitios de referencia de confianza en Cloud Console.

Revisa la configuración de la cuota

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 consultar 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

Advertencia: El uso del ID de cliente en los servicios del cliente de la API de Maps JavaScript no consume la cuota del proyecto. Una vez que migres a una clave de API, tu uso consumirá la cuota del proyecto. Debes asegurarte de tener suficiente margen de cuota antes de migrar.

Si utilizas los siguientes servicios en la API de Maps JavaScript, verás que el uso de la cuota aumenta 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 Cloud Console.
   • 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".

Método de la API	Servicio del cliente	Servicio para ajustar la cuota
google.routes.Directions.Javascript	Servicio Directions	API de Directions
google.routes.DistanceMatrix.Javascript	Servicio Distance Matrix	API de Distance Matrix
google.maps.Elevation.Javascript	Servicio Elevation	API de Elevation
google.places.Geocoding.Javascript	Servicio Geocoding	API de Geocoding
google.places.*.Javascript, excepto google.places.Geocoding.Javascript	Biblioteca de Places	API de Places

• 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 la granularidad por segundo y por día.
  • Gráfico de solicitudes por segundo: Multiplica el tráfico máximo por 60 para obtener la cuota adicional por minuto que necesitas.
  • Gráfico de Per Day: El tráfico máximo debe ser la cuota adicional por día que se necesita.
• Ajusta tu cuota en los servicios correspondientes de Maps Platform.
  • 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 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 del canal para la generación de 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 numérico compatible.

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 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.

Secreto de firma 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 realizar pruebas, pero comienzan a fallar una vez que alcanzan el umbral en tu producción. Reemplaza tu 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.

Advertencia: Antes de implementar cambios de código en la producción, verifica que la funcionalidad de extremo a extremo no se haya visto afectada.

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.

Cómo detener tu ID de cliente

Recomendamos que los desarrolladores pausen los IDs de cliente después de la migración. Esto se hace para proteger tus credenciales del tráfico no deseado y confirmar que el uso restante de tu ID de cliente no es crítico (p. ej., pruebas, cachés, bots, etc.) y puede devolver errores sin causar un impacto comercial. Puedes pausar tu ID de cliente en Cloud Console. Consulta la Descripción general de la autenticación del plan Premium para obtener más detalles.

Solución de problemas

¿Cómo podemos saber 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 OverQuotaMapError o OVER_QUERY_LIMIT si la cuota configurada no es suficiente para cubrir tu tráfico. Revisa la sección "Revisa la configuración de la cuota" y ajusta la cuota según corresponda.

Error "Las solicitudes a esta API deben realizarse a través de 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"
}