Google Maps APIs for Work Lista de comprobación previa al lanzamiento

Esta página está destinada únicamente a clientes con una licencia anterior de Maps APIs for Work o Maps API for Business. Esta página no está destinada a clientes con el nuevo Google Maps APIs Premium Plan, que se encuentra disponible desde enero de 2016.

  1. Controlar que tu equipo tenga acceso a los recursos necesarios
    1. Recibir la carta de bienvenida de las Google Maps APIs for Work
    2. Tener acceso al Google Cloud Support Portal y usarlo
    3. Suscribirse a feeds de notificación pertinentes
    4. Disponer de una línea directa de asistencia
  2. Optimización de la aplicación
    1. Configurar el firewall para permitir el acceso a los servicios de Google Maps APIs
    2. Cargar las API a través de SSL
    3. Usar Maps API de cliente en tus dominios SSL
    4. Seleccionar la versión de API correspondiente
    5. Optimizar el uso de la vista de página
    6. Comparar el diseño de cliente y de servidor: Elegir el correcto para tu caso de uso
    7. Cuota y administración de servicios web
    8. Pruebas de carga
  3. Migrar del modo gratuito a implementaciones de Google Maps APIs for Work
    1. Autorizar el dominio
    2. Integrar el ID de tu cliente
    3. Usar la clave criptográfica para firmar solicitudes de servicios web
    4. Seguimiento del uso de aplicaciones y el parámetro Channel
    5. Eliminar parámetros obsoletos de tus solicitudes de API

Controlar que tu equipo tenga acceso a los recursos necesarios

Recibir la carta de bienvenida de las Google Maps APIs for Work

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

Tener acceso al Google Cloud Support Portal y usarlo

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 permitirá presentar casos de asistencia al equipo de asistencia de Google Maps APIs 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 permanecer actualizado respecto de los desarrollos y cambios en las Google Maps APIs, te recomendamos suscribirte a las fuentes de notificación pertinentes. Debes suscribirte al blog de Google Geo Developers y a las notificaciones de Grupos de Google correspondientes según las API que uses, como se describe en el siguiente enlace:

https://developers.google.com/maps/faq#notify

A continuación, tómate un momento y suscríbete a los grupos de notificaciones para las API que estés usando o planeando usar. Tal vez desees suscribirte al siguiente feed de RSS:

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

para recibir actualizaciones desde los equipos de asistencia Google Maps APIs.

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 más 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:

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

Optimización de la aplicación

Configurar el 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 Google Maps APIs.
  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 para permitir solicitudes, según la API y el caso de uso.

Cargar las API a través de SSL

Por qué es importante: las aplicaciones que carguen la Maps JavaScript API, las Web Service API o las API de imagena través de SSL deben hacerlo desde https://maps.googleapis.com como alternativa al nombre de host heredado, https://maps-api-ssl.google.com.

Usar Maps API de cliente en tus dominios SSL

Por qué es importante: cuando uses una API de clientes 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 nuestro artículo Autorización de solución de problemas para implementaciones de Google Maps APIs for Work.

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.

También es fundamental comprender el esquema de versiones de las API para evitar el uso accidental de una versiones no apropiadas de estas en tu entorno:

https://developers.google.com/maps/documentation/javascript/versions

Por ejemplo, resultará adecuado usar la versión nocturna de las API (es decir, experimental) en tu entorno de desarrollo y prueba, pero no aconsejamos de ninguna manera usar la versión nocturna 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.

Optimizar el uso de la vista de página

Por qué es importante: si no muestras siempre un mapa de Google en tu sitio, ¿por qué pagar por ello? Como práctica recomendada para usar las vistas de tu página, sugerimos cargar las Maps API de manera asincrónica en estas páginas donde se muestra un mapa. Esto reducirá notablemente el número de vistas de páginas compradas que tus aplicaciones consuman. Ten en cuenta que con cada actualización de una página que carga la API habrá una vista de página adicional. Como resultado, cuando diseñes tu aplicación, te recomendamos que aquel de tus sitios que cargue la API solo inicie actualizaciones de la página cuando sea absolutamente necesario.

Comparar el diseño de cliente y de servidor: Elegir el correcto para tu caso de uso

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, se debe usar un enfoque de cliente para las secciones de tus aplicaciones que interactúen 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.

Cuota y Administración de servicios web

Por qué es importante: de forma predeterminada, la cuota de servicios web se fija en 100 000 consultas por 24 horas. Para hallar un desglose de cuota más detallado por API, consulta la documentación sobre límites de uso. Para confirmar el volumen de cuota disponible para tu ID de cliente, 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 el artículo sobre los Límites de uso para los servicios web de Google Maps APIs. Comprender e implementar estos conceptos reducirá enormemente las posibilidades de que tu aplicación exceda su cuota permitida, sea bloqueada por Google o falle.

Pruebas de carga

Por qué es importante: 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 : https://github.com/googlemaps/js-v2-samples/blob/gh-pages/mock_maps_apis/. Puedes cargar esto en tu propia aplicación de App Engine (después de registrar una en https://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 tus API de una licencia gratuita a Google Maps APIs for Work

Autorizar el dominio

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 con nuestro equipo de asistencia para todos los sitios que usarán tu 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.

La Google Street View Image API y Google Static Maps API pueden usarse mediante cliente o servidor; ambos generan vistas de página. Como resultado, estas API requieren que firmes tus solicitudes usando tu clave criptográfica y también autorices cualquier dominio que use estas API. Esto garantiza que tu aplicación se facture de modo apropiado, conforme a nuestros ToS, y quede sujeta a nuestro SLA.

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 el tratamiento de problemas de autorización, recomendamos repasar el artículo Autorización de solución de problemas para implementaciones de Google Maps APIs for Work antes de presentar un caso.

Integrar el ID de tu cliente (p. ej., &client=gme-yourclientid)

Por qué es importante: una de las medidas más importantes que puedes tomar es asegurarte de incluir “&client=gme-yourclientid” en tus solicitudes. Se puede encontrar tu ID único de cliente en tu carta de bienvenida que se envió a los contactos principales de tu organización. El ID de cliente identifica tus solicitudes como una solicitud Google Maps APIs for Work. Debes incluir tu ID de cliente en tus aplicaciones para beneficiarte con cualquier función específica de Google Maps APIs for Work. También debes incluir tu ID de cliente para recibir asistencia técnica y asegurarte de que tu aplicación esté sujeta a nuestro SLA.

Usar la clave criptográfica (p. ej., vNIXE0xscrmjlyV-12Nj_BvUPaw=) para firmar solicitudes de servicios web

Por qué es importante: tu clave criptográfica privada se usa para generar firmas que comunican a Google que tus solicitudes provienen de una fuente confiable. Tu clave criptográfica puede hallarse en tu carta de bienvenida enviada a los contactos principales de tu organización. Nuestros servicios web exigen que, como cliente de Google Maps APIs for Work, firmes tus solicitudes usando tu clave criptográfica. Esto agrega en la parte superior de tu solicitud una capa de seguridad que protegerá la cuota asociada con tu ID de cliente.

Ten en cuenta que la clave criptográfica se usa para generar firmas. No se anexa a tus solicitudes como una firma en sí misma. 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 Google Maps APIs for Work 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 Google Maps Geocoding API actualmente no exige firmas). Consulta nuestra documentación sobre firmas de URL:

https://developers.google.com/maps/premium/previous-licenses/webservices/auth

Seguimiento del uso de aplicaciones y el parámetro Channel

Por qué es importante: 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, aparecerán 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:

https://developers.google.com/maps/premium/previous-licenses/clientside/quota#reporting

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.

Eliminar parámetros obsoletos de tus solicitudes de API (p. ej., “&key=ABQIAAAA…”)

Por qué es importante: para cargar de manera correcta la Google Maps JavaScript API debes incluir tu ID de cliente. También debes quitar cualquier parámetro key. Si en tu solicitud se incluye un ID de cliente y una clave, fallará.

Sigue la guía Google Maps APIs for Work para obtener información completa sobre cómo formatear de modo correcto solicitudes de Google Maps APIs for Work por API: https://developers.google.com/maps/premium/previous-licenses/