Lista de tareas previas al lanzamiento

Dónde administrar tu ID de cliente en Google Cloud Console

La funcionalidad de administración de ID de clientes del plan premium está migrando desde el Portal de asistencia a Cloud Console en la página Credenciales de Maps, en la sección Cuentas de servicio.

La nueva área de ID de cliente en la página Credenciales

Nota: 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

Mantén la carta de bienvenida del plan premium de Google Maps Platform en un lugar seguro

Por qué es importante: Tu carta de bienvenida es tu kit para principiantes del plan premium de Google Maps Platform y probablemente sea tu principal fuente de consulta. Contiene datos críticos como tu ID del proyecto de Google Cloud Console, tu ID de cliente y tu clave criptográfica, elementos necesarios para comenzar a usar el plan premium. También contiene toda la información que necesitas para comunicarte con el equipo de asistencia al cliente del plan premium si experimentas problemas técnicos con cualquiera de las API de Google Maps.

Usa 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, te permite presentar casos de ayuda al equipo de asistencia al cliente del plan premium si tienes problemas técnicos durante el desarrollo o el lanzamiento.

Antes del lanzamiento, habilita el acceso a Cloud Console para todos los desarrolladores a cargo del mantenimiento de tu aplicación. Si experimentas problemas técnicos, el acceso a Cloud Console permite que los miembros de tu equipo se pongan en contacto con el servicio de asistencia y también que nuestro equipo de asistencia al cliente se ponga en contacto con las partes interesadas pertinentes 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)

Suscríbete a feeds de notificaciones pertinentes

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 los feeds de notificaciones pertinentes, como se describe en las Preguntas frecuentes.

También puedes suscribirte al siguiente feed RSS para recibir anuncios de la API premier de Google Maps: interrupciones, actualizaciones, notificaciones de servicio:

http://google.force.com/services/xml/MapsRSS

Dispón de una línea directa de asistencia

1-877-355-5787 para clientes de EE.UU. y +1 404-978-9282 para clientes fuera de EE.UU.

Por qué es importante: La línea directa es la manera de comunicarte con el servicio de asistencia telefónica. Los números para cada país están disponibles en Cloud Console, junto con el PIN. Aunque puedes usar la línea directa de asistencia para informar problemas técnicos a nuestro equipo, ten en cuenta que esta se reserva solo para los casos de pérdida de producción y falta de disponibilidad de los servicios. Nuestros niveles de prioridad se definen en este documento:

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.

Carga las API con el nombre de host SSL correcto

Por qué es importante: Las aplicaciones que cargan las API de Google Maps a través de SSL deben hacerlo desde https://maps.googleapis.com en lugar del nombre de host heredado https://maps-api-ssl.google.com.

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 correspondiente

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

Por qué es importante: De forma predeterminada, la cuota compartida de servicios web se establece en 100,000 solicitudes gratuitas diarias. Para obtener un desglose de cuota más detallado por API, consulta la documentación sobre los límites de uso. Verifica tus cuotas en Cloud Console o envía un caso de ayuda si tienes algún problema de cuota.

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 aplicación

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.

Las pruebas de carga con los servicios de Google en tiempo real harán que tu aplicación exceda la cuota permitida y que Google la bloquee. Google Maps Platform puede entregar volúmenes muy altos. En 2012, Sigue a Santa entregó 1,600,000 solicitudes por segundo. Por lo tanto, no es necesario realizar pruebas de carga con los servicios de Google. Las pruebas de carga de tu aplicación deben garantizar que esta pueda manejar grandes volúmenes de solicitudes sin exceder tus cuotas para las API de Google Maps. Ejemplo: Si tu cuota para la API de Geocoding es de 20 QPS (consultas por segundo), las pruebas de carga de tu aplicación deben garantizar que esta pueda manejar 600 QPS sin enviar más de 20 QPS a la API de Geocoding.

Para lograr esto de manera segura, las pruebas de carga deben realizarse con una API de prueba (falsa), es decir, un servicio que pueda absorber grandes cantidades de solicitudes y reaccionar con respuestas válidas, sin que intervenga Google Maps Platform. Por lo tanto, puedes realizar pruebas de carga en tu aplicación sin correr el riesgo de que Google Maps Platform la bloquee.

Consulta este ejemplo de una API de prueba, implementada como una aplicación pequeña de Google App Engine. Puedes subir este ejemplo a tu propia aplicación de App Engine (después de registrar una en appengine.google.com) y hacer que la aplicación envíe solicitudes allí en lugar de hacerlo a maps.googleapis.com.

Por lo general, las cuotas de App Engine predeterminadas (gratuitas) bastarán para realizar pruebas de carga en tu aplicación que excedan ampliamente tus cuotas para los servicios web de las API de Google Maps. Asegúrate de que tu aplicación establezca el encabezado User-Agent correcto para habilitar la compresión de respuestas. Esto es fundamental para garantizar el uso eficiente del ancho de banda, lo cual es particularmente importante para una aplicación de App Engine que entrega un gran volumen de respuestas con texto sin formato (JSON/XML). Si necesitas una cuota más alta para tu aplicación de App Engine, también puedes habilitar la facturación, aunque esto rara vez sea necesario.

Migra tu aplicación de una licencia estándar a una premium

Incluye tu ID de cliente o clave de API en las solicitudes a la API

Por qué es importante: Una de las medidas más importantes que puedes tomar respecto de tu aplicación es asegurarte de incluir tu ID de cliente (gme-yourclientid) o tu clave de API (que tiene esta forma: AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0) en tus solicitudes a la API. El ID de cliente o la clave de API identifica tus solicitudes como una solicitud del plan premium de Google Maps Platform.

Debes incluir tu ID de cliente o clave de API en tus aplicaciones para aprovechar cualquier función específica del plan premium. También debes incluir tu ID de cliente o clave de API para recibir asistencia técnica y asegurarte de que tu aplicación esté sujeta a nuestro ANS.

Para la mayoría de las API, puedes optar por un ID de cliente o una clave de API. Tu ID de cliente se incluye en la carta de bienvenida que se envió a los contactos principales de tu organización. Puedes generar tus propias claves de API en Google Cloud Console.

Los detalles están en la guía de autenticación y autorización.

Incluye la clave de API o el ID de cliente en las solicitudes a la API, pero no ambos

Por qué es importante: Para cargar correctamente la API de Maps JavaScript o enviar una solicitud a otras API de Google Maps, debes incluir tu ID de cliente o tu clave de API, pero no ambos. Si optas por usar un ID de cliente, debes quitar cualquier parámetro key. Si tu solicitud incluye tanto un ID de cliente como una clave, tu aplicación puede experimentar comportamientos o errores inesperados.

Sigue la guía de autenticación y autorización para obtener información completa sobre cómo aplicar el formato correcto a las solicitudes del plan premium por API.

Si usas un ID de cliente, autoriza tus dominios para usarlos con la API de Maps JavaScript

Por qué es importante: Para evitar que sitios no autorizados usen tu ID de cliente, la API de Maps JavaScript requiere que autorices todos los dominios a través de nuestro equipo de asistencia al cliente para todos los sitios que usarán tu ID de cliente (no es necesario registrar la URL si usas una clave de API en lugar de un ID de cliente). Si las URL autorizadas a usar tu ID de cliente no coinciden con el sitio que intenta usarlo, este no podrá usar la API con tu ID de cliente. Puedes autorizar dominios en cualquier momento. Por eso, asegúrate de haber autorizado los dominios para todos tus sitios antes de tu lanzamiento.

Puedes verificar tu lista de dominios autorizados en Cloud Console. Para ello, ve a la páginaCredenciales y desplázate hasta la secciónID de cliente.

Si tienes problemas de autorización, te recomendamos que revises la guía para solucionar problemas de autorización antes de presentar un caso.

Si usas un ID de cliente, firma solicitudes de servicios web mediante una firma generada con tu clave criptográfica privada

Por qué es importante: Tu clave criptográfica privada se usa para generar firmas digitales que comunican a Google que tus solicitudes provienen de una fuente confiable. Nuestras API de servicio web requieren que agregues una firma digital a tus solicitudes, si usas un ID de cliente para la autenticación. Esto agrega una capa de seguridad en la parte superior de tu solicitud que protegerá mejor la cuota asociada con tu ID de cliente. Tu clave criptográfica (por ejemplo, vNIXE0xscrmjlyV-12Nj_BvUPaw=) se incluye en tu carta de bienvenida, la cual se envía a los contactos principales de tu organización.

Nota: La clave criptográfica se usa para generar firmas. No la adjuntes a tus solicitudes como una firma en sí misma. Tu clave criptográfica es similar al número de PIN del cajero automático. Se usa como medio de autenticación para acceder a tu cuenta y nunca debe compartirse abiertamente ni ser visible ante fuentes poco confiables. Nuestros servidores rechazarán las solicitudes de servicios web del plan premium que no se hayan firmado correctamente, por lo que es fundamental que tu aplicación firme la solicitud de forma adecuada antes del lanzamiento. Consulta la guía de autenticación y autorización.

Realiza un seguimiento del uso de la aplicación

Por qué es importante: Como cliente del plan premium, tienes acceso a informes detallados sobre el uso de tu aplicación, incluidos los créditos consumidos, las solicitudes realizadas, los errores mostrados y mucho más. Consulta la guía sobre informes.

channel es un parámetro opcional que te permite realizar un seguimiento del uso en función de tu ID de cliente mediante la asignación de un canal distinto a cada una de tus aplicaciones. No es necesario registrar este tipo de parámetro en tu ID de cliente. Cuando agregues el parámetro channel a tu solicitud a la API, los resultados de uso por canal comenzarán a aparecer en los informes de uso del portal de asistencia 1 o 2 días después de la implementación. Tú decides dónde se implementan los canales y, por lo tanto, cómo se calcula tu uso. Antes del lanzamiento, determina si tu aplicación debe incorporar parámetros channel para realizar un seguimiento del uso de tu aplicación.

El parámetro channel debe usar el siguiente formato:

  • Debe ser una string ASCII alfanumérica.
  • Se permiten los siguientes caracteres: punto (.), guion bajo (_) y guion (-).
  • El parámetro channel distingue entre mayúsculas y minúsculas. Los parámetros channel en mayúsculas sostenidas, mayúsculas y minúsculas, y todos en minúsculas se combinan para formar su equivalente en minúsculas. Por ejemplo, el uso en el canal CUSTOMER se combina con el uso en el canal customer.

Puedes implementar hasta 2,000 canales distintos por ID de cliente.

Para usar el parámetro channel, inclúyelo en la URL de solicitud junto con el parámetro client que se usa para pasar el ID de cliente.

Ten en cuenta que el parámetro channel debe ser un valor asignado estadísticamente por aplicación. No debe generarse de modo dinámico ni usarse para realizar un seguimiento de usuarios individuales.