Lista de comprobación previa al lanzamiento

Controlar que tu equipo tenga acceso a los recursos necesarios

Mantener tu carta de bienvenida de Google Maps APIs Premium Plan en algún lugar seguro

Por qué es importante: tu carta de bienvenida es tu kit para principiantes de Google Maps APIs Premium Plan y probablemente sea tu botiquín de primeros auxilios. Contiene bits críticos de información como tu ID de proyecto de Google API Console, tu ID de cliente y tu clave criptográfica, elementos necesarios para comenzar a usar las Premium Plan. También contiene toda la información que necesitas para contactar al equipo del Premium Plan si experimentas un problema técnico con cualquiera de las Google Maps API.

Usar el Google Cloud Support Portal

Por qué es importante: el portal de asistencia te ofrece acceso a elementos informativos como informes de uso, feeds de noticias y recursos útiles para desarrolladores. Lo que es más importante, te permite presentar casos de asistencia al equipo de asistencia de Premium Plan si experimentas problemas técnicos durante el desarrollo o el lanzamiento. Puedes acceder al portal de asistencia en la siguiente URL:

https://google.secure.force.com/

Antes del lanzamiento, dedica tiempo a habilitar el acceso al portal de asistencia para todos los desarrolladores a cargo del mantenimiento de tu aplicación. Si experimentas problemas técnicos, el acceso al portal de asistencia tiene la doble ventaja de permitir que los miembros de tu equipo se pongan en contacto con el servicio de asistencia y que nuestro equipo de asistencia se ponga en contacto con las partes interesadas pertinentes de tu organización. Por ejemplo, es posible que el equipo de asistencia deba ponerse en contacto con tu organización si detectamos tráfico o comportamiento anormal que puedan dañar tu aplicación. Asegurarnos de contar con un grupo pertinente de desarrolladores a los que podamos contactar puede ser la diferencia entre una pérdida de servicio inesperada y la prevención de esta. Si no tienes acceso al portal de asistencia, solicítalo aquí:

Solicitar una cuenta en el Google Cloud Support Portal

Suscribirse a feeds de notificación pertinentes

Por qué es importante: para asegurarte de que estar actualizado respecto de los desarrollos y cambios en las Maps API, te recomendamos suscribirte a los feeds de notificación pertinentes, como se describe en Preguntas frecuentes.

También te puedes suscribir al siguiente feed de RSS para recibir los anuncios de Google Maps Premier API; pérdidas, actualizaciones y notificaciones de servicio:

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

Disponer 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 tu alternativa para llamar a Google Cloud Support Portal. Agrega esta página a marcadores para encontrar el número de línea directa de asistencia actualizado. 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 casos de pérdida de producción e indisponibilidad de servicios. Nuestros niveles de prioridad se definen en este documento:

https://support.google.com/work/answer/184028

Optimizar tu aplicación

Configurar un firewall para permitir el acceso a los servicios de Google Maps APIs

Por qué es importante: los servicios Google Maps APIs usan diferentes dominios, de los cuales algunos no pertenecen al dominio *google.com. Si usas un firewall restrictivo, es importante permitir el acceso a los dominios usados por cada servicio de Maps API. Si tu firewall no permite el acceso a estos dominios, las solicitudes de API fallarán, lo cual puede dañar tus aplicaciones. Puedes encontrar una lista completa de dominios usados por las Maps API en el portal de asistencia:

  1. Accede al Google Cloud Support Portal.
    El portal de asistencia solo se encuentra disponible para clientes que usen la Google Maps APIs Premium Plan o una Google Maps APIs for Work anterior o una licencia de Google Maps for Business.
  2. Dirígete a la pestaña Recursos.
  3. Selecciona una Lista de dominios usados por la familia de Google Maps APIs. (Aquí se ofrece el enlace directo.)
  4. Permite que tus aplicaciones accedan a los dominios enumerados.

No recomendamos administrar restricciones de firewall mediante direcciones IP, ya que los IP asociados con estos dominios no son estáticos.

Nota: Los servicios de Google Maps APIs 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 y también solicitudes, según la API y el caso de uso.

Cargar las API con el nombre de host SSL correcto

Por qué es importante: las aplicaciones que carguen las Maps API en SSL deben hacerlo desde https://maps.googleapis.com como alternativa al nombre de host heredado, https://maps-api-ssl.google.com.

Autorizar tus dominios SSL para usarlos con la Google Maps JavaScript API

Por qué es importante: cuando uses la Google Maps JavaScript API con un dominio SSL, será fundamental que hayas autorizado de manera explícita tus dominios HTTPS para asegurarte de que no se rechacen tus solicitudes. Ten en cuenta que la autorización de http://yourdomain.com no habilita automáticamente su equivalente SSL, https://yourdomain.com. Puedes verificar tu lista de dominios autorizados en el Google Cloud Support Portal seleccionando el vínculo Maps: Manage Client ID, a la izquierda. Para solucionar problemas relacionados con el uso de las API de cliente con dominio SSL, te sugerimos a verificar primero si algún elemento de tu página se carga en HTTP. Consulta también la guía de autorización de solución de problemas.

Seleccionar la versión de API correspondiente

Por qué es importante: antes de desarrollar tu aplicación, es importante tener en cuenta las versiones de API obsoletas. Optar por realizar desarrollos con las versiones no obsoletas de las API te ahorrará tiempo de desarrollo y costos una vez que dejen de estar disponibles las versiones obsoletas.

En particular, es fundamental comprender el esquema de versiones que usa la Google Maps JavaScript API para evitar el uso accidental de una versión no apropiada de la API en tu entorno.

Por ejemplo, resultará adecuado usar la versión experimental de la API en tu entorno de desarrollo o prueba, pero no aconsejamos de ninguna manera usar la versión experimental en un entorno de producción. Nuestro SLA solo se aplica a versiones estables de las API, de modo que solo debes usar estas versiones en tu entorno de producción.

Consulta la guía de versiones de Google Maps JavaScript API.

Elegir entre un diseño de cliente y uno de servidor

Por qué es importante: elegir un enfoque de cliente o de servidor es una decisión relacionada con la arquitectura y tiene una importancia crítica para la estabilidad y escalabilidad de tu aplicación. Por lo general, se debe usar un enfoque de servidor para el procesamiento previo o posterior de registros sin conexión (es decir, fuera de tu aplicación). Como alternativa, un enfoque de cliente se debe usar para las porciones de tus aplicaciones que interactúan con tus usuarios (es decir, solicitudes enviadas a usuarios del proceso en tiempo real).

La implementación de un enfoque de servidor cuando en lugar de este debe usarse un enfoque de cliente es la causa principal del exceso de cuotas y, por lo tanto, de fallas en aplicaciones. Te recomendamos consultar el documento Estrategias de geocodificación antes de designar o lanzar aplicaciones que se basen en llamadas de servidor.

Optimizar el uso de cuotas

Por qué es importante: comprender el modo en que tu aplicación consume cuota, conocida como “créditos” de Maps API, te ayuda a reducir el monto que debes pagar. Por ejemplo, si usas la Google Maps JavaScript API, tu aplicación consume créditos de Maps API por cada carga de mapa. Consulta la guía de índices y límites de uso de Premium Plan.

Administrar el uso de cuotas de tus servicios web

Por qué es importante: de forma predeterminada, la cuota compartida de servicios web se fija en 100 000 solicitudes gratuitas diarias. Para hallar un desglose de cuota más detallado por API, consulta la guía de límites de uso. Para confirmar el volumen de cuota disponible para tu proyecto, presenta un caso de asistencia.

Antes de lanzar tu servicio, es fundamental que comprendas los diferentes errores relacionados con la cuota (p. ej., OVER_QUERY_LIMIT y User Rate Limit Exceeded) y que establezcas la lógica apropiada en tu aplicación para poder responder a esos errores al exceder tu cuota. Comienza leyendo las preguntas frecuentes de los límites de uso. Para obtener información sobre los códigos de estado que muestra cada API, consulta la guía del desarrollador para esa API. Por ejemplo, consulta la guía de códigos de estado de Google Maps Directions API. Comprender e implementar estos conceptos reducirá enormemente las posibilidades de que tu aplicación exceda su cuota permitida, sea bloqueada por Google o 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 volúmenes altos sin exceder tus cuotas para las Maps API.

Las pruebas de carga con servicios de Google en tiempo real harán que tu aplicación exceda la cuota permitida y que Google la bloquee. Google Maps APIs puede mostrar volúmenes muy altos; en 2012, Santa Tracker mostró 1 600 000 solicitudes por segundo. Por lo tanto, es necesario realizar pruebas de cargas con servicios de Google. Como alternativa, realizar pruebas de carga de tu aplicación garantizará que tu aplicación pueda manejar volúmenes altos de solicitudes sin exceder tus cuotas para las Maps API. Ejemplo: si tu cuota para la Google Maps Geocoding API 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 Google Maps Geocoding API.

Para alcanzar esto de manera segura, las pruebas de carga deben realizarse a partir de una API de prueba (falsa), un servicio que puede absorber grandes cantidades de solicitudes y responderlas con respuestas válidas, sin involucrar las Google Maps APIs. Por lo tanto, puedes realizar pruebas de cargas de tu aplicación sin arriesgarte a que las Google Maps APIs te apliquen bloqueos.

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

Por lo general, las cuotas de App Engine predeterminadas (gratuitas) bastarán para realizar pruebas de carga de tu aplicación gratuita que excedan ampliamente tus cuotas para los servicios web de Maps API. Asegúrate de que tu aplicación establezca el encabezado Usuario-Agente correcto para habilitar la compresión de respuestas. Esto es fundamental para garantizar el uso eficaz del ancho de banda, lo cual es particularmente importante para una aplicación de App Engine que ofrece un volumen alto 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.

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

Incluye tu ID de cliente o clave de API en solicitudes de API

Por qué es importante: una de las cosas más importantes que puedes hacer por tu aplicación es asegurarte de incluir tu ID de cliente (gme-yourclientid) o tu clave de API (AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0) en tus solicitudes de API. El ID de cliente o la clave de API identifica tus solicitudes como una solicitud de Google Maps APIs Premium Plan.

Debes incluir tu ID de cliente o clave de API en tus aplicaciones para beneficiarte con cualquier función específica de Premium Plan. 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 SLA.

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 enviada a los contactos primarios de tu organización. Puedes generar tus propias claves de API en el Google API Console.

Hay información disponible en la guía de autenticación y autorización.

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

Por qué es importante: Para cargar de modo correcto la Google Maps JavaScript API o enviar una solicitud a otras Google Maps API, debes incluir tu ID de cliente o tu clave API, pero no ambos. Si optas por un ID de cliente, debes quitar cualquier parámetro key. Si en tu solicitud se incluye un ID de cliente y una clave, fallará.

Sigue las indicaciones de la guía de autenticación y autorización para obtener información completa sobre cómo formatear correctamente solicitudes de Premium Plan por API.

Al usar un ID de cliente, autorizar tus dominios para usarlos con la Google Maps JavaScript API

Por qué es importante: Para evitar que sitios no autorizados usen tu ID de cliente, nuestra Google Maps JavaScript API te exige autorizar todos los dominios a través de nuestro equipo de asistencia 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 no coinciden las URL autorizadas a usar tu ID de cliente con el sitio que intenta usarla, tu sitio no podrá usar las API con tu ID de cliente. Puedes autorizar dominios en cualquier momento. Por ellos, asegúrate de haber autorizado los dominios para todos tus sitios antes de tu lanzamiento.

Puedes verificar tu lista de dominios autorizados en el Google Cloud Support Portal seleccionando el vínculo Maps: Manage Client ID, a la izquierda.

Para resolver problemas de autorización, te recomendamos revisar la guía de autorización de solución de problemas antes de presentar un caso.

Al usar un ID de cliente, firmar solicitudes de servicios web usando 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 Web Service API exigen que agregues una firma digital a tus solicitudes, si usas un ID de cliente para autenticación. Esto agrega en la parte superior de tu solicitud una capa de seguridad que protegerá la cuota asociada con tu ID de cliente. Tu clave criptográfica (por ejemplo, vNIXE0xscrmjlyV-12Nj_BvUPaw=) se incluye en tu carta de bienvenida enviada 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 firma. Tu clave criptográfica es similar a un número de identificación personal para 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 desconocidas. Nuestros servidores rechazarán las solicitudes de servicios web de Premium Plan que no se hayan firmado correctamente; por ello, es fundamental que tu aplicación firme de modo correcto la solicitud antes del lanzamiento (nb. v2 actualmente no exige firmas). Consulta la guía de autenticación y autorización.

Realizar un seguimiento del uso de la aplicación

Por qué es importante: como cliente del Premium Plan, tienes acceso a informes detallados sobre el uso de tu aplicación; se incluyen, entre otros, solicitudes realizadas, créditos consumidos, errores mostrados. Consulta la guía de informes.

un parámetro channel es un parámetro opcional que te permite seguir el uso en tu ID de cliente asignando un canal distinto a cada una de tus aplicaciones. No es necesario registrar los parámetros en tu ID de cliente. Con solo agregar el parámetro channel a tu solicitud de API, los resultados de uso por canal comenzarán a aparecer en los informes de uso de tu portal de asistencia 1 o 2 días después de la implementación. Dependerá de ti decidir el punto en que se aplicarán tus canales y, por lo tanto, la manera en que se agregará tu uso. Decide antes del lanzamiento si tu aplicación debe integrarse a los parámetros channel para seguir el uso de tu aplicación:

El parámetro channel debe tener el siguiente formato:

  • Debe ser una string ASCII alfanumérica.
  • Se permiten caracteres como el punto (.), el guión bajo (_) y el guión medio (-).
  • En el caso del parámetro channel, se distinguen mayúsculas de minúsculas; los parámetros channel en mayúsculas, mayúsculas y minúsculas, y minúsculas se combinan para formar su equivalente en minúscula. Por ejemplo, el uso en el canal CUSTOMER se combina con el uso en el canal customer.

Puedes implementar hasta 2000 canales distintos por ID de cliente.

Para usar el parámetro channel, inclúyelo en la URL de solicitud con el parámetro client usado 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.