Dónde administrar tu ID de cliente en la consola de Google Cloud
La función de administración de IDs de cliente del plan Premium está disponible en la Cloud Console en la parte inferior de la En la página Credenciales de Google Maps Platform, en la sección ID de cliente
Se puede acceder a más tareas de administración del ID de cliente, incluidas la autorización de URLs y la administración de secretos de firma, en la página del ID de cliente independiente. Para ello, haz clic en el ícono de editar en el extremo derecho de la sección ID de cliente (Client ID).
Importante: El plan Premium de Google Maps Platform ya no está disponible para registros o clientes nuevos.
Asegúrate de que tu equipo tenga acceso a los recursos necesarios
Uso de Google Cloud Console
Por qué es importante: Google Cloud Console te brinda acceso a información tal como informes de uso, feeds de noticias y recursos para desarrolladores. Y, lo que es más importante, la consola de Cloud te permite presentarle casos al equipo de asistencia al cliente de Google Maps Platform si tienes problemas técnicos durante el desarrollo o el lanzamiento.
Antes de un lanzamiento, habilita el acceso a la consola de Cloud para todos los desarrolladores a cargo del mantenimiento de tu aplicación. Si experimentas problemas técnicos, el acceso a la consola de Cloud permite que los miembros de tu equipo se comuniquen con el servicio de asistencia y también que nuestro equipo de asistencia al cliente se comunique con las partes interesadas de tu organización. Por ejemplo, es posible que el equipo de asistencia al cliente deba ponerse en contacto con tu organización si detectamos tráfico o comportamiento anormal que pueda dañar tu aplicación. El hecho de poder comunicarnos con los desarrolladores apropiados podría ser la diferencia entre una interrupción inesperada y su prevención.
Suscríbete a grupos de notificaciones por correo electrónico
Por qué es importante: Para asegurarte de estar al tanto de los desarrollos y los cambios en las API de Google Maps, te recomendamos que te suscribas a uno o más de los siguientes grupos de correo electrónico:
- google-maps-platform-notifications: Actualizaciones técnicas acerca de las API y los servicios web de Google Maps Platform, notificaciones de interrupciones y anuncios sobre funciones de la plataforma (aproximadamente 3-5 mensajes por mes)
- google-maps-js-api-v3-notify: Nuevos lanzamientos de la API de Google Maps JavaScript (aproximadamente 4 mensajes por año)
Optimiza tu aplicación
Configura un firewall para permitir el acceso a los servicios de Google Maps Platform
Por qué es importante: Los servicios de Google Maps Platform usan diferentes dominios, algunos de los cuales no pertenecen al dominio *google.com
. Si usas un firewall restringido, es importante permitir el acceso a los dominios que usa cada servicio de las API de Google Maps. Si tu firewall no permite el acceso a estos dominios, las solicitudes a la API fallarán, lo que puede dañar tus aplicaciones. Consulta una lista completa de los dominios que usan las API de Google Maps.
No recomendamos administrar las restricciones de firewall por dirección IP, ya que los IP asociados con estos dominios no son estáticos.
Nota: Los servicios de Google Maps Platform usan el puerto 80 (http) y 443 (https) para el tráfico de entrada y salida. Estos servicios también requieren solicitudes GET, POST, PUT, DELETE y HEAD. Configura tu firewall para permitir el tráfico en estos puertos, como así también solicitudes, según la API y el caso de uso.
Autoriza tus dominios SSL para usarlos con la API de Maps JavaScript
Por qué es importante: Cuando uses la API de Maps JavaScript con un dominio SSL, es fundamental que hayas autorizado de manera explícita tus dominios HTTPS para garantizar que no se rechacen las solicitudes. Ten en cuenta que autorizar http://yourdomain.com
no habilita automáticamente su equivalente SSL, es decir, https://yourdomain.com
. Para verificar tu lista de dominios autorizados en Cloud Console, desplázate hacia abajo hasta la sección ID de cliente. Para solucionar errores relacionados con el uso de las API del cliente que tienen un dominio SSL, verifica si algún elemento de tu página se carga en HTTP. Consulta la guía para solucionar problemas de autorización.
Selecciona la versión de API adecuada
Por qué es importante: Antes de desarrollar tu aplicación, es importante tener en cuenta qué versiones de las API dejaron de estar disponibles. Optar por realizar desarrollos con las versiones no obsoletas de las API te ahorrará tiempo y costo de desarrollo una vez que dejen de estar disponibles las versiones obsoletas.
En particular, es fundamental comprender el esquema de control de versiones que usa la API de Maps JavaScript para evitar el uso accidental de una versión inapropiada de la API en tu entorno.
Por ejemplo, es posible que resulte adecuado usar la versión experimental de la API en tu entorno de desarrollo o de pruebas, pero no aconsejamos de ninguna manera usar esa versión en un entorno de producción. Nuestro ANS solo se aplica a versiones estables de las API, de modo que solo debes usar versiones de este tipo en tu entorno de producción.
Consulta la guía sobre las versiones de la API de Maps JavaScript.
Elige entre un diseño de cliente y uno de servidor
Por qué es importante: Elegir un enfoque del cliente o del servidor es una decisión relacionada con la arquitectura y tiene una importancia crítica en términos de la estabilidad y la escalabilidad de tu aplicación. En líneas generales, se debe usar un enfoque del servidor para el procesamiento previo o posterior de registros sin conexión (es decir, fuera de tu aplicación). Como alternativa, un enfoque del cliente se debe usar para las partes de tus aplicaciones que interactúan con tus usuarios (es decir, para procesar las solicitudes que envían los usuarios en tiempo real).
Implementar un enfoque del servidor cuando debería usarse uno del cliente es la causa principal del exceso de cuotas y, por lo tanto, de las fallas en las aplicaciones. Te recomendamos enfáticamente consultar las estrategias de geocodificación antes de diseñar o lanzar aplicaciones que se basen en llamadas del servidor.
Optimiza el uso de cuotas
Por qué es importante: Comprender la forma en que tu aplicación consume la cuota, conocida como créditos de las API de Google Maps, te ayuda a reducir el monto que pagas. Por ejemplo, si usas la API de Maps JavaScript, tu aplicación consume créditos de API de Google Maps por cada carga de mapa. Consulta la guía sobre índices y límites de uso del plan premium.
Administra el uso de cuotas de tus servicios web
Antes de lanzar tu servicio, es fundamental que comprendas los diferentes errores relacionados con la cuota (por ejemplo, OVER_QUERY_LIMIT
, User Rate Limit
Exceeded
) y que configures la lógica adecuada en tu aplicación para poder responder a esos errores cuando excedas tu cuota. Para comenzar, lee las Preguntas frecuentes sobre los límites de uso.
Para obtener información sobre los códigos de estado que muestra cada API, consulta la Guía para desarrolladores de la API correspondiente. Por ejemplo, consulta la guía sobre códigos de estado de la API de Directions.
Comprender y también implementar estos conceptos reducirá enormemente las posibilidades de que tu aplicación exceda su cuota permitida, que Google la bloquee o que falle.
Realiza pruebas de carga en tu app
Por qué es importante: Usa las pruebas de carga de tu aplicación para asegurarte de que pueda manejar grandes volúmenes de solicitudes sin exceder tus cuotas para las API de Google Maps.
Aunque Google Maps Platform puede manejar volúmenes de tráfico muy altos, hacer pruebas con los servicios de Google en vivo hará que tu aplicación exceda la cuota permitida y que Google, potencialmente, la bloquee. También eres responsable de los cargos de uso que se generen por las pruebas de carga.
En su lugar, las pruebas de carga de tu aplicación deberían garantizar que esta pueda manejar grandes volúmenes de solicitudes sin exceder tus cuotas para las API de Google Maps y sin que Google las bloquee. Para hacerlo de manera segura, realiza pruebas de carga con una API de prueba (falsa). Se trata de un servicio que puede absorber grandes cantidades de solicitudes y responder a las solicitudes con respuestas válidas, sin involucrar a Google Maps Platform. Ejemplo: Si tu cuota para la API de Geocoding es de 3,000 QPM (consultas por minuto) realizar pruebas de carga con tu aplicación debería garantizar que esta pueda manejar un volumen mucho mayor, como 90,000 QPM sin enviar más de 3,000 QPM a la API de Geocoding.
Si planeas realizar una prueba de carga significativa, comunícate con el equipo de Atención al cliente de Google para obtener orientación y asegurarte de que Google esté al tanto de las pruebas planificadas.