Preguntas frecuentes sobre Google Maps Platform

Introducción

Explicación de las Condiciones del Servicio

Facturación y límites de uso

Uso de Google Maps Platform

Errores y solución de problemas

Servicios de Google Maps Platform

SDK de Google Maps para iOS

SDK de Google Maps para Android

Firma de URL

Comenzar

¿Qué es Google Maps Platform?

Google Maps Platform es un conjunto de API y SDK que los desarrolladores pueden usar a fin de incorporar Google Maps en apps para dispositivos móviles y páginas web o recuperar datos de Google Maps. Se ofrecen diferentes productos. Según tus necesidades, podrías usar una sola API o SDK o una combinación de las diferentes opciones:

Maps:

Routes:

Places:

¿Cómo puedo comenzar a usar Google Maps Platform?

Consulta Cómo comenzar a utilizar Google Maps Platform.

¿Qué API necesito?

Si deseas ayuda para encontrar la API adecuada según tus requisitos funcionales, consulta el selector de API.

¿Cómo empiezo a usar las API en mi sitio?

Consulta las guías de descripción general, para desarrolladores y de introducción correspondientes la API o el SDK específicos que te interesan. Por ejemplo, consulta las guías para el SDK de Maps para Android o la API de Maps JavaScript.

¿En qué países está disponible Google Maps Platform?

Constantemente, el equipo de Google Maps presenta datos de mapas nuevos y aumenta nuestra cobertura internacional. Consulta los datos de cobertura de Google Maps para conocer la información más actualizada sobre la cobertura. Puedes filtrar los datos con el cuadro de filtros en la parte superior de la página. Ten en cuenta que los datos de cobertura pueden cambiar si se modifican los acuerdos de licencia con los proveedores de datos.

Consulta también lo siguiente:

¿Puedo colocar Google Maps en mi sitio sin usar los productos de Google Maps Platform?

Sí. Ahora Google Maps ofrece la capacidad de incorporar el mapa que estás viendo en tu sitio web o blog, sin programación y sin usar Google Maps Platform. Puedes encontrar más información aquí.

¿Cómo puedo ofrecer aplicaciones de Maps en dispositivos móviles?

Si deseas incorporar mapas en una aplicación para Android, utiliza el SDK de Maps para Android.

A fin de incorporar mapas en una aplicación para iOS nativa, utiliza el SDK de Maps para iOS.

La API de Maps JavaScript se desarrolló específicamente para los dispositivos móviles y es adecuada para aplicaciones de navegadores diseñadas para computadoras de escritorio y para dispositivos que incluyen un navegador web con implementación completa de JavaScript, como el iPhone de Apple.

En el caso de las aplicaciones diseñadas para dispositivos no compatibles con la API de Maps JavaScript, la API de Maps Static proporciona imágenes de mapas en formatos GIF, JPG y PNG, incluidos marcadores y polilíneas. Ten en cuenta que, para usar la API de Maps Static fuera de las aplicaciones que se basan en un navegador, la imagen del mapa debe estar vinculada a Google Maps.

¿Qué navegadores web son compatibles con la API de Maps JavaScript y la API de Maps Embed?

La API de Maps JavaScript y la API de Maps Embed son compatibles con los siguientes navegadores web:

Computadoras de escritorio
  • La versión actual de Microsoft Edge (Windows)
  • Las versiones actual y anterior de Firefox (Windows, macOS y Linux)
  • Las versiones actual y anterior de Chrome (Windows, macOS y Linux)
  • Las versiones actual y anterior de Safari (macOS)

A partir de agosto de 2021, se mostrará un mensaje de advertencia a los usuarios de Internet Explorer 11 en la parte superior de los mapas. La última versión de la API de Maps JavaScript compatible con Internet Explorer 11 es la 3.47. La compatibilidad con Internet Explorer 11 se descontinuará completamente en agosto de 2022. Esto también se aplica al modo IE en Edge.

Android
  • La versión actual de Chrome en Android 4.1 y versiones posteriores
  • La versión actual de Chrome WebView en Android 4.4 y versiones posteriores
iOS
  • Mobile Safari en las versiones principales actual y anterior de iOS
  • UIWebView y WKWebView en las versiones principales actual y anterior de iOS
  • La versión actual de Chrome para iOS
¿Puedo imprimir mapas desde la API de Maps JavaScript?

No se admiten impresiones desde la API de Maps JavaScript. Esto se debe a que la compatibilidad con la impresión no es uniforme en los navegadores más utilizados.

¿Cómo me notifican si hay cambios en los productos de Google Maps Platform?

Debes suscribirte al blog de Google Maps Platform a fin de conocer las novedades sobre las diferentes ofertas de Google Geo para desarrolladores.

¿Cómo puedo comunicarme con el equipo de asistencia técnica?

Consulta Asistencia y recursos de Google Maps Platform para obtener información sobre las opciones de asistencia disponibles.

¿Cuándo está disponible la asistencia técnica?
El equipo de asistencia al cliente está disponible las 24 horas, de lunes a las 9 a.m., hora de Tokio, a viernes a las 5 p.m., hora del Pacífico, sin incluir los feriados regionales, para problemas de "servicio no utilizable".
¿Cómo puedo recuperar el acceso a mi Cuenta de Google?

Si perdiste el acceso a tu Cuenta de Google (p. ej., juan@miempresa.com o juan@gmail.com), puedes intentar recuperar o restablecer la contraseña para volver a tener acceso. Consulta el artículo Cómo recuperar tu Cuenta de Google o de Gmail en la Ayuda de Cuenta de Google.

¿Cómo puedo recuperar el acceso a un proyecto específico?

Si perdiste el acceso al proyecto dentro del cual administras la implementación de Google Maps Platform, puedes intentar recuperarlo.

Si tienes acceso a la Cuenta de Google asociada con tu proyecto, recuerda lo siguiente:

Si no tienes acceso a la Cuenta de Google asociada con tu proyecto, haz lo siguiente:

¿Puedo utilizar el SDK de Maps y Places para iOS en Mac con procesadores ARM?

Es posible realizar desarrollos en las nuevas Mac con procesadores ARM. Sin embargo, las compilaciones y las ejecuciones deben hacerse en un dispositivo iOS físico. Esta es una limitación temporal mientras buscamos agregar más compatibilidad con el desarrollo en simuladores.

Explicación de las Condiciones del Servicio

¿Cuáles son las condiciones del servicio de los productos de Google Maps Platform?

Las Condiciones del Servicio de Google Maps Platform están disponibles en la siguiente URL:

https://cloud.google.com/maps-platform/terms

¿Mi sitio cumple con las Condiciones del Servicio de Google Maps Platform?

Puedes usar Google Maps Platform en tus aplicaciones siempre que tu sitio cumpla con las Condiciones del Servicio de Google Maps Platform.

Sin embargo, existen determinados usos de Google Maps Platform que no admitimos: por ejemplo, mapas que identifican lugares donde comprar drogas ilegales en una ciudad o cualquier otra actividad ilegal. También respetamos la privacidad de las personas. Por eso, Google Maps Platform no debe usarse para identificar información privada de individuos.

Debes buscar asesoramiento propio para determinar si tu aplicación satisface las Condiciones del Servicio de Google Maps Platform antes de desarrollarla y lanzarla. Los ingenieros de Google solo pueden ofrecer asistencia técnica y no están calificados para ofrecer asesoramiento legal. Google se reserva el derecho de suspender o resolver tu uso del servicio en cualquier momento. Por lo tanto, lee las Condiciones de las API de Google Maps con atención.

¿Puedo acceder directamente a mosaicos de mapas y a imágenes satelitales?

No puedes acceder a los mosaicos de mapas ni a las imágenes satelitales mediante ningún mecanismo que no sea Google Maps Platform (como la creación de tu propia API de mapas o el uso de una secuencia de comandos para descargar mosaicos de forma masiva). Se bloqueará el acceso de tu aplicación a los mosaicos si esta accede a ellos por fuera de Google Maps Platform. Consulta las Condiciones del Servicio de Google Maps Platform para obtener más información.

¿Puedo usar los productos de Google Maps Platform para aplicaciones de seguimiento?

No existe ninguna restricción para utilizar los productos de Google Maps Platform a fin de publicar datos en tiempo real (seguimiento), siempre que la aplicación cumpla con las Condiciones del Servicio de Google Maps Platform.

¿Puedo usar Google Maps Platform en una aplicación no disponible en la Web?

Sí, los productos de Google Maps Platform ahora se pueden usar en aplicaciones que no estén disponibles en la Web, siempre que cumplan con las demás restricciones de las Condiciones del Servicio de Google Maps Platform.

La API de Maps JavaScript solo se admite cuando se ejecuta en uno de los navegadores compatibles.

¿Puedo usar los productos de Google Maps Platform en un sitio protegido con contraseña?

Sí, los servicios de Google Maps, Routes y Places se pueden usar con aplicaciones de acceso privado. Consulta las Condiciones del Servicio de Google Maps Platform para obtener más información.

¿Puedo crear una aplicación que incluya datos de Google Maps Platform en un documento?

Si tu aplicación genera un documento, ya sea en formato impreso o electrónico, este no puede incluir datos ni imágenes de Google Maps Platform. Consulta la sección "No se permite el scraping" de las Condiciones del Servicio de Google Maps Platform para obtener más detalles.

¿Cómo puedo rechazar la inclusión de mi contenido en los resultados de la Búsqueda de Google?

Ya no recopilamos esos datos. El parámetro indexing no se usa más y quedó sin efecto. Ya no es necesario que rechaces explícitamente incluir tu contenido, pero te recomendamos que quites este parámetro lo antes posible.

Para quitar tu página o sitio de los resultados de la búsqueda, sigue las instrucciones que se proporcionan en nuestro Centro de ayuda para webmasters.

¿Puedo generar una imagen de mapa con la API de Maps Static que almaceno y publico en mi sitio web?

No puedes almacenar ni entregar copias de imágenes generadas con la API de Maps Static desde tu sitio web. Todas las páginas web que requieren imágenes estáticas deben vincular el atributo src de una etiqueta img de HTML o el atributo background-image de CSS de una etiqueta div de HTML directamente con la API de Maps Static para que todas las imágenes de mapas se muestren en el contenido HTML de la página web y Google las entregue directamente a los usuarios finales.

Facturación y límites de uso

¿Cómo configuro la facturación para mi proyecto?
Consulta Cómo comenzar a utilizar Google Maps Platform.
¿Cómo se actualizan los clientes del nivel gratuito de Google Cloud Platform a una cuenta pagada?
El programa Nivel gratuito de Google Cloud Platform brinda a los clientes una prueba gratuita de USD 300 para usar con cualquier servicio de Google Cloud Platform (GCP), incluidas las API de Google Maps Platform (GMP). Cuando finalice la prueba gratuita, debes actualizar tu cuenta a una pagada a fin de seguir usando estos servicios. Para ello, visita Cloud Console.
¿Tiene Google Maps Platform límites de uso?

No hay límites diarios máximos respecto de la cantidad de solicitudes que se pueden realizar a los productos de Google Maps Platform. Los únicos límites de uso se relacionan con la cantidad máxima de "consultas por segundo" (QPS). En la siguiente tabla, se muestra el límite de QPS para cada API:

API Límite de QPS

Directions

50 QPS

Distance Matrix

1,000 QPS

Elevation

100 QPS

Geocoding

50 QPS

Geolocation

100 QPS

Dynamic Maps

500 QPS

Static Maps

500 QPS

API de Street View Image

500 QPS

Time Zone

500 QPS

Places (JavaScript y Web)

100 QPS

Roads

500 QPS

A fin de controlar los gastos, puedes supervisar el uso de las API y establecer límites diarios para todas las solicitudes que se hagan a cualquier API facturable.

La implementación de los productos de Google Maps Platform debe cumplir con las Condiciones del Servicio de Google Maps Platform estándares.

¿Cómo se calcula el costo de uso?

Para obtener una descripción general de los precios de los productos de Google Maps Platform, consulta la Tabla de precios.

Para obtener más información sobre cómo se facturan las API de Google Maps Platform, consulta Explicación de la facturación de Maps, Routes y Places.

¿Cómo se cuentan las cargas de mapa en Google Maps Platform?

Se cobrará una carga de mapa cuando ocurra cualquiera de las siguientes circunstancias:

  • Una página web o una aplicación utiliza la API de Maps JavaScript para mostrar un mapa.
  • Una aplicación solicita una sola imagen de mapa desde la API de Maps Static.

Las panorámicas de Street View se cobran de forma independiente de las cargas de mapa:

  • Se cobra una panorámica de Street View estática por cada solicitud a la API de Street View Static para incorporar una panorámica de Street View estática (no interactiva).
  • Se cobra una panorámica de Street View dinámica por cada instancia de un objeto de panorámica en una aplicación de la API de Maps JavaScript, el SDK de Maps para Android o el SDK de Maps para iOS.

Una vez que una página web o aplicación carga un mapa, una imagen de mapa estática o una panorámica de Street View, las interacciones del usuario con ese objeto (como el desplazamiento lateral, el zoom o el cambio entre capas del mapa) no generan cargas de mapa adicionales ni influyen en los límites de uso.

¿Cómo superviso mi uso?

Puedes supervisar el uso de API individuales en Google Cloud Console.

  1. Selecciona el proyecto que contiene la API que deseas revisar.
  2. En la lista de API del panel, haz clic en el nombre de la API.
  3. Cerca de la parte superior de la página, haz clic en Métricas o Cuotas.

Para ver un informe de tráfico y datos de facturación de un proyecto completo, sigue estos pasos:

  1. Si aún no lo hiciste, configura la facturación.
  2. Ve a la página de facturación de Cloud Console.
  3. Selecciona un proyecto.
  4. En la barra lateral izquierda, haz clic en Informes. Usa los filtros de la barra lateral derecha para ver los informes relacionados con tu cuenta de facturación.

Para obtener más información, consulta Informes de Google Maps Platform, Supervisar el uso de API y Limitar el uso de API.

¿Qué sucede si excedo los límites de porcentaje de solicitudes (QPS)?

Si excedes los límites de QPS de un producto determinado de Google Maps Platform, la API mostrará un mensaje de error. Si esto sucede de forma reiterada, tu acceso a la API puede bloquearse temporalmente.

Si excedes los límites de QPS de solicitudes o haces un uso inadecuado del servicio de otra manera, las solicitudes mostrarán un mensaje de error específico. Si esto sigue sucediendo, se podría bloquear tu acceso a Google Maps Platform.

Nota: Cuatro de las API de servicio web tienen un servicio del cliente equivalente disponible en la API de Maps JavaScript: Directions, Distance Matrix, Elevation y Geocoding.

Límites de uso excedidos

Si excedes los límites de uso, recibirás un código de estado OVER_QUERY_LIMIT como respuesta.

Esto significa que el servicio web dejará de proporcionar respuestas normales y pasará a mostrar solo el código de estado OVER_QUERY_LIMIT hasta que se vuelva a autorizar más capacidad de uso. Esto puede ocurrir al cabo de unos pocos segundos si el error se recibió porque tu aplicación envió demasiadas solicitudes por segundo.

Si superas tus límites de uso de QPS con frecuencia, considera optimizar las aplicaciones para que utilicen los productos de Google Maps Platform de manera más eficiente y, así, reducir el uso. Consulta la Guía de optimización para obtener más información.

Mi sitio recibe mucho tráfico. ¿Puedo usar los productos de Google Maps Platform?

Sí. Pero te recomendamos que te familiarices con los límites de uso correspondientes al producto de Google Maps Platform del cual depende tu aplicación.

Una vez que tengas una cuenta de facturación, si excedes el límite de uso mensual gratuito de USD 200 y no tienes una forma de pago válida en tu cuenta de facturación (como tarjeta de crédito, transferencia bancaria, etc.), la API dejará de funcionar hasta que agregues una forma de pago válida.

¿Cómo se calculará y facturará el uso?

El uso se calcula al final de cada día, con el precio que figura en la Tabla de precios. Al final de cada mes, el uso total se cobra a la forma de pago asociada con tu cuenta de facturación. Para obtener más información, consulta Facturación de Google Maps Platform.

¿Cuánto cuesta usar Google Maps Platform?

Consulta la Tabla de precios para ver una descripción general del costo por API. Si tu aplicación genera solicitudes o volúmenes de cargas de mapa por debajo del uso gratuito de USD 200 mensuales, tu uso es gratuito. El uso que supere el crédito mensual de USD 200 se cobrará a tu cuenta de facturación. Si deseas obtener más detalles, consulta nuestra guía para comprender la facturación de Google Maps Platform.

¿Están disponibles los precios en otras monedas?

Es posible que, en la consola, haya monedas adicionales disponibles. Si seleccionas una moneda diferente, las tarifas se convertirán al equivalente del precio en USD que figura en nuestra Tabla de precios.

Ya configuré la facturación. ¿Cómo veo mi factura?

Al principio de cada mes, Google te cobra la actividad del mes anterior mediante la forma de pago que hayas especificado. Si deseas obtener más información sobre tu factura, consulta nuestra guía para comprender la facturación de Google Maps Platform.

Recursos adicionales:

¿Cómo evito una factura costosa si mi uso aumenta de forma inesperada?

Google Maps Platform proporciona formas de establecer límites de solicitud diarios y establecer límites máximos de facturación por día. Puedes restringir el límite máximo diario de uso para protegerte contra los aumentos inesperados. También puedes configurar alertas de presupuesto para recibir notificaciones por correo electrónico cuando los cargos en la cuenta de facturación alcancen el umbral que estableciste.

Cómo restringir el límite máximo diario de facturación:

A fin de evitar una factura costosa, puedes establecer un límite diario de uso para protegerte contra los aumentos inesperados. Puedes cambiar este límite en Cloud Console mediante los pasos siguientes:

  1. Ve al panel API y servicios.
  2. Si se te solicita, selecciona un proyecto.
  3. Selecciona una API de la lista y, luego, haz clic en la pestaña Cuotas.
  4. Haz clic en el ícono de editar junto a la cuota "solicitudes por día".

De forma alternativa, puedes editar varias cuotas para múltiples API mediante el panel Cuotas que se encuentra en IAM y administración.

Cómo configurar y administrar alertas de presupuesto:

Configura alertas de presupuesto para que se envíen notificaciones por correo electrónico a los administradores de facturación cuando los cargos en la cuenta de facturación alcancen el umbral que estableciste. Los administradores de facturación recibirán notificaciones por correo electrónico cuando los cargos estimados en la cuenta de facturación excedan el 50%, 90% y 100% del umbral.

Recibí un mensaje que señala que mi proyecto está vinculado a la "Cuenta de transición de Google Maps Platform", pero no tengo acceso a esa cuenta. ¿Qué debo hacer?

La "Cuenta de transición de Google Maps Platform" se creó para ayudar a determinados clientes a realizar la transición a nuestro nuevo plan de precios con la modalidad de prepago. Esta cuenta de transición permitió que Google ofreciera un crédito único a estos clientes para que puedan seguir usando Google Maps Platform hasta el límite de USD 200 del nivel gratuito. Una vez que se supere ese límite, se cerrará la cuenta de facturación y se perderá el acceso al servicio. Para evitar las interrupciones del servicio, te sugerimos que configures tu propia cuenta de facturación. Así, podrás seguir disfrutando el crédito mensual de USD 200 del nivel gratuito. Sigue estos pasos para cambiar la cuenta de facturación de tu proyecto:

  1. Crea una cuenta de facturación nueva (si ya tienes una, puedes omitir este paso).
  2. Asocia la cuenta de facturación a tu proyecto.
¿Por qué mi límite de cuota está configurado en 1 solicitud por día? ¿Cómo puedo aumentar este límite?

Si no creaste una cuenta de facturación y la vinculaste a tu proyecto, tus API de Maps Platform se limitarán a 1 solicitud por día. Para obtener una cuota mayor, crea y adjunta una cuenta de facturación. Para ello, consulta Cómo comenzar a utilizar Google Maps Platform.

Una vez que hayas creado y vinculado una cuenta de facturación, se quitará el límite de cuota diario. Puedes decidir establecer un límite en Cloud Console a fin de evitar un gasto inesperado.

Recibí un aviso de incumplimiento de facturación. ¿Cómo lo resuelvo?

Recibiste este aviso porque Google determinó que tu cuenta utiliza varias cuentas de facturación. Esto constituye un incumplimiento de las condiciones de Google, tal como se define en el artículo 3.2.4 de las Condiciones del Servicio de Google Maps Platform. Según estas condiciones, no está permitido crear varias cuentas de facturación. Para obtener más información, consulta Preguntas frecuentes sobre el incumplimiento de las condiciones relacionadas con las cuentas de facturación.

Uso de Google Maps Platform

¿Qué claves o credenciales debo usar para los diferentes productos de Maps?

Cada vez que utilizas los productos de Google Maps Platform, debes incluir una clave de API para validar tu solicitud. Google Maps Platform está disponible para aplicaciones web, de iOS y Android y a través de servicios web HTTP.

Clave de API:

  • Una clave de API es un identificador único que generas con Cloud Console.
  • Ejemplo de carga de una API con una clave: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Firma digital:

  • Una firma digital se genera usando un secreto de firma de URL que te proporciona Google. Las firmas digitales se usan con la API de Maps Static y la API de Street View Static.

Restricciones:

  • Restringir la clave de API es opcional, pero te recomendamos que lo hagas con todas las claves de API para mayor seguridad. Consulta las prácticas recomendadas relacionadas con la seguridad de la API para obtener más información.
  • Puedes agregar una restricción de la aplicación a la clave de API. Una vez restringida, la clave solo funcionará en plataformas que admitan ese tipo de restricción. Hay cuatro tipos de restricciones de aplicación disponibles. Las API que aplican el mismo tipo de restricción pueden usar la misma clave restringida.
    • Direcciones IP (servidores individuales): Se usa con las API de servicio web.
    • URL de referencia de HTTP (sitios web): Se usa con las API web.
    • Restricción de las apps para Android (por nombre de paquete y huella digital): Se usa con el SDK de Maps para Android.
    • Restricción de las apps para iOS (por identificador de paquete de iOS): Se usa con el SDK de Maps para iOS.
  • También puedes agregar una restricción de API a la clave de API. Para obtener más información, consulta Cómo obtener, agregar y restringir una clave de API.

En la siguiente tabla, se indica la restricción de clave/credencial y la restricción de aplicación para cada API o SDK de Google Maps Platform.

API/SDK Restricción de credencial y aplicación
SDK de Maps para Android Clave de API con restricción de Android1
SDK de Places para Android Clave de API con restricción de Android1
SDK de Maps para iOS Clave de API con restricción de iOS1
SDK de Places para iOS Clave de API con restricción de iOS1
API de Maps JavaScript Clave de API con restricción de URL de referencia de HTTP1
API de Maps Static Clave de API con restricción de URL de referencia de HTTP1 + firma digital2
API de Street View Static Clave de API con restricción de URL de referencia de HTTP1 + firma digital2
API de Maps Embed Clave de API con restricción de URL de referencia de HTTP1
API de Directions Clave de API con restricción de dirección IP1
API de Distance Matrix Clave de API con restricción de dirección IP1
API de Elevation Clave de API con restricción de dirección IP1
API de Geocoding Clave de API con restricción de dirección IP1
API de Geolocation Clave de API con restricción de dirección IP1
API de Roads Clave de API con restricción de dirección IP1
API de Time Zone Clave de API con restricción de dirección IP1
API de Places Clave de API con restricción de dirección IP1
1 Restringir la clave de API es opcional, pero te recomendamos que lo hagas con todas las claves de API para mayor seguridad.
2 Según el uso, es posible que se requiera una firma digital para la API de Maps Static y la API de Street View Static. Sin importar el uso, te recomendamos que uses tanto una clave de API como una firma digital para autenticar tus solicitudes.
¿Cómo puedo cambiar el tipo de restricción de clave para que se base en la dirección IP en lugar de hacerlo en la URL de referencia de HTTP?

Importante: Si usas cualquiera de las API de servicio web con una clave de API que tiene restricciones de URL de referencia, tus solicitudes no funcionarán, y se mostrará el siguiente mensaje de error: "API keys cannot have referer restrictions when used with this API.". Debes comenzar a usar una clave de API con restricciones de dirección IP.

Antes de cambiar el tipo de restricción de la clave de API de URL de referencia de HTTP a dirección IP, asegúrate de que todas las API que usan la clave de API admitan la restricción de dirección IP. Las API que tienen el mismo tipo de restricción pueden usar la misma clave restringida. Si necesitas aplicar más de una restricción, agrega otra clave con la restricción requerida. Consulta cómo agregar una nueva clave de API.

Obtén más información sobre las restricciones de las claves de API asociadas a los productos de Google Maps Platform.

Para cambiar la restricción de una clave de API de URL de referencia de HTTP a dirección IP, sigue estos pasos:

  1. Ve a la página Credenciales de Cloud Console.
  2. Selecciona el proyecto que contenga la clave de API que desees editar.
  3. En la página Credenciales, en la lista de claves de API, selecciona el nombre de la clave a la que desees editarle los detalles.
  4. En la sección Restricciones de clave de la página, selecciona “Direcciones IP (servidores web, trabajos cron, etc.)” y, luego, inserta las direcciones IP de servidor adecuadas. Después, haz clic en Guardar.
¿Cómo puedo obtener una nueva clave de API?
Consulta Cómo comenzar a utilizar Google Maps Platform.
¿Cómo puedo encontrar los cambios introducidos en cada versión de las API de Google Maps?

En los siguientes vínculos, puedes encontrar información sobre los cambios introducidos en cada versión de muchas de las API de Google Maps:

También puedes consultar la Herramienta de seguimiento de errores de Google Maps Platform para ver en qué versión de esta plataforma se introdujo y se corrigió un error específico. Puedes acceder a la herramienta mediante el siguiente vínculo:

https://issuetracker.google.com/bookmark-groups/76561

¿Cómo puedo cargar la API a una página de forma asíncrona después de que se carga la página?

Solo debes especificar el parámetro "callback" cuando cargues la API. Puedes encontrar más información y un código de muestra en el capítulo Introducción de la documentación de la API de Maps JavaScript.

¿Cómo puedo hacer que los productos de Google Maps Platform se muestren en un idioma que no sea inglés?

De forma predeterminada, la API intentará cargar el idioma más adecuado en función de la ubicación de los usuarios o la configuración del navegador. Algunas API te permiten definir explícitamente el idioma cuando realizas una solicitud. Puedes obtener más información acerca de cómo configurar el idioma en la documentación correspondiente a cada API:

Idiomas admitidos:

Google actualiza con frecuencia los idiomas admitidos. Es posible que esta lista no esté completa. Además, está sujeta a cambios.

Código de idioma Idioma Código de idioma Idioma
af Afrikáans ja Japonés
sq Albanés kn Canarés
am Amárico kk Kazajo
ar Árabe km Jemer
hy Armenio ko Coreano
az Azerí ky Kirguís
eu Vasco lo Laosiano
be Bielorruso lv Letón
bn Bengalí lt Lituano
bs Bosnio mk Macedonio
bg Búlgaro ms Malayo
my Birmano ml Malabar
ca Catalán mr Maratí
zh Chino mn Mongol
zh-CN Chino (simplificado) ne Nepalí
zh-HK Chino (Hong Kong) no Noruego
zh-TW Chino (tradicional) pl Polaco
hr Croata pt Portugués
cs Checo pt-BR Portugués (Brasil)
da Danés pt-PT Portugués (Portugal)
nl Neerlandés pa Punyabí
en Inglés ro Rumano
en-AU Inglés (Australia) ru Ruso
en-GB Inglés (Gran Bretaña) sr Serbio
et Estonio si Cingalés
fa Persa sk Eslovaco
fi Finés sl Esloveno
fil Filipino es Español
fr Francés es-419 Español (Latinoamérica)
fr-CA Francés (Canadá) sw Suajili
gl Gallego sv Sueco
ka Georgiano ta Tamil
de Alemán te Telugu
el Griego th Tailandés
gu Gujarati tr Turco
iw Hebreo uk Ucraniano
hi Hindi ur Urdu
hu Húngaro uz Uzbeko
is Islandés vi Vietnamita
id Indonesio zu Zulú
it Italiano

Puedes usar esta aplicación de muestra para ver cómo quedará el mapa en cualquiera de los idiomas mencionados.

¿Se puede acceder a Google Maps Platform a través de SSL (HTTPS)?

Se puede acceder a la API de Maps JavaScript, la API de Maps Static y las API de servicio web mediante conexiones seguras (HTTPS). Consulta la documentación correspondiente a la API en cuestión a fin de obtener información sobre cómo acceder a la API a través de SSL.

Ten en cuenta que la API de Maps Static no admite URL de íconos personalizados que usen HTTPS. Se mostrará el ícono predeterminado.

¿Cómo informo un error o solicito una función nueva en Google Maps Platform?

Si experimentas un comportamiento que crees que es un error, primero publícalo en el foro correspondiente. De esta forma, los programadores podrán validar el error y descartar cualquier problema potencial con tu código.

Si deseas solicitar una función, primero publica el pedido en el foro correspondiente para confirmar que no exista ya una solución que cumpla con tus requisitos.

Una vez que hayas confirmado que identificaste un error nuevo o que tus requisitos no se pueden satisfacer con las funciones existentes de los productos de Google Maps Platform, informa el error o la solicitud de función mediante la Herramienta de seguimiento de errores de Google Maps Platform.

Antes de agregar un error o una solicitud de función a la Herramienta de seguimiento de errores, asegúrate de revisar que no figuren ya en la lista. Si ya están incluidos, puedes destacar el problema con una estrella para registrar tu interés y recibir una notificación cuando haya actualizaciones.

¿Cómo utilizan las API de Google Maps Platform las cookies del sitio?

El SDK de Maps para Android y el SDK de Maps para iOS usan cookies sujetas a la Política de Privacidad de Google, como las que se usan para calcular los usuarios activos diarios y de 7 días, y para evitar el abuso del servicio. Estas cookies no están asociadas con ninguna Cuenta de Google a la que se haya accedido y no se registran con el resto de la información recopilada de las llamadas a la API.

No encuentro la respuesta a mi pregunta. ¿Con quién debo comunicarme?

El equipo de Developer Relations de Google mantiene presencia en Stack Overflow, un sitio de preguntas y respuestas para programadores editado de forma colaborativa. Es un excelente lugar para hacer preguntas técnicas sobre el desarrollo y mantenimiento de aplicaciones de Google Maps. Si deseas obtener más información sobre cómo formular preguntas en Stack Overflow, consulta la página Asistencia.

Para obtener los mejores resultados al momento de solicitar ayuda, ten en cuenta lo siguiente:

  • Busca en los foros de debate actuales. Es probable que alguien más haya experimentado un problema similar y haya encontrado una solución.
  • Envía un vínculo a tu sitio si es posible. Solo publica fragmentos de código si el código no se ve fácilmente en línea.
  • Proporciona toda la información relevante, incluidos los errores, las versiones del navegador y todos los demás datos que puedan resultar útiles para solucionar este problema.

Errores y solución de problemas

¿Qué significa este error?

Si encuentras un error durante la carga o la ejecución de las API de Google Maps, consulta los siguientes vínculos para encontrar explicaciones de los códigos de error:

Mis mapas se ven más oscuros de lo habitual. ¿Qué sucede?

En ciertas circunstancias, es posible que se muestre un mapa oscuro o una imagen "negativa" de Street View, que incluya una marca de agua con el texto "for development purposes only". Este comportamiento generalmente indica problemas con una clave de API o la facturación. Para usar los productos de Google Maps Platform, debes tener una cuenta de facturación, y todas las solicitudes deben incluir una clave de API válida. El siguiente flujo de preguntas y respuestas te ayudará a solucionar este problema:


¿Cómo resuelvo los códigos de error OVER_DAILY_LIMIT y OVER_QUERY_LIMIT?
Estos códigos de error pueden mostrarse por cualquiera de los siguientes motivos:
  • Falta la clave de API en la solicitud.
  • La clave de API proporcionada no es válida.
  • El proyecto no tiene una cuenta de facturación vinculada.
  • Se superó un límite de uso autoimpuesto.
  • La forma de pago proporcionada ya no es válida (por ejemplo, si venció una tarjeta de crédito).
  • Superaste los límites de QPS para una API determinada.

Para usar los productos de Google Maps Platform, debes tener una cuenta de facturación, y todas las solicitudes deben incluir una clave de API válida. Para solucionar este problema, sigue estos pasos:

¿Cómo resuelvo los códigos de error kGMSPlacesRateLimitExceeded y 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Si ves los errores kGMSPlacesRateLimitExceeded o 9005 PLACES_API_RATE_LIMIT_EXCEEDED, es posible que estés usando una versión obsoleta del SDK de Places para Android o el SDK de Places para iOS. Obtén más información y encuentra los nuevos SDK en https://goo.gle/places-sdk-deprecation.
¿Cómo resuelvo el error "This IP, site or mobile application is not authorized to use this API key."?

Este error puede deberse a diferentes situaciones:

  • Habilitaste las restricciones de dirección IP (servidor) en tu clave de API, y una dirección IP no autorizada está intentando hacer una solicitud.
  • Habilitaste las restricciones de URL de referencias de HTTP (sitio web) en tu clave de API, y una URL de referencia no autorizada está intentando hacer una solicitud.
  • Restringiste el uso de tus apps para Android mediante la configuración de un nombre de paquete y una huella digital, y una app para Android no autorizada está intentando hacer una solicitud.
  • Restringiste las solicitudes desde apps para iOS mediante la especificación de identificadores de paquete, y una app para iOS no reconocida está intentando enviar una solicitud.
  • Antes, se podía recibir este error si se usaba cualquiera de las API de servicio web con una clave de API que tuviera restricciones de URL de referencia de HTTP. Las solicitudes a esas API se deben identificar con una clave de API que tengan restricciones de dirección IP. Cambia el tipo de restricción de tu clave para que se base en la dirección IP en lugar de hacerlo en la URL de referencia de HTTP. Para obtener más información sobre cómo restringir las claves de API, consulta Prácticas recomendadas relacionadas con las claves de API.

Visualiza y edita tus credenciales de clave de API

Para ver tus claves de API y administrar las restricciones, sigue estos pasos:

  1. Ve a la página Credenciales de Cloud Console.
  2. Selecciona el proyecto que contenga la clave de API que desees revisar.
  3. Para ver detalles de las credenciales, incluidas las restricciones configuradas para la clave, selecciona el nombre de esta en la lista de claves de API.
  4. Se muestran las credenciales completas de la clave de API seleccionada, incluidas las restricciones que tiene configuradas. Desde aquí, puedes cambiar, borrar o actualizar según las restricciones según sea necesario.
¿Cómo resuelvo el error "API keys with referer restrictions cannot be used with this API."?

Usas alguna de las API de servicio web con una clave de API que tiene restricciones de URL de referencia de HTTP. Por cuestiones de seguridad, las API de servicio web deben usar claves de API con restricción de direcciones IP. Cambia el tipo de restricción de tu clave para que se base en la dirección IP en lugar de hacerlo en la URL de referencia de HTTP. También puedes crear una clave de API nueva si tu clave ya está en uso en la API de Maps JavaScript.

Servicios de Google Maps Platform

Necesito convertir direcciones en pares de coordenadas de latitud/longitud. ¿Puedo hacerlo con Google Maps Platform?

Sí. Este proceso se llama "geocodificación". La API de Maps JavaScript incluye una clase para realizar el servicio de geocodificación. La clase es: google.maps.Geocoder.

Como alternativa, Google también proporciona la API de Geocoding, la cual ofrece una interfaz REST que puede responder en formatos JSON y XML.

¿En qué países está disponible la geocodificación?

Para ver los países que actualmente admiten los geocodificadores de Google Maps Platform, consulta los datos de cobertura de Google Maps.

La precisión de las ubicaciones geocodificadas puede variar según el país. Por lo tanto, considera usar el campo location_type que se muestra para determinar si se encontró una coincidencia lo suficientemente adecuada para los propósitos de tu aplicación. Ten en cuenta que la disponibilidad de los datos de geocodificación depende de nuestros contratos con proveedores de datos, por lo que está sujeta a cambio.

¿Por qué los geocodificadores de Google Maps Platform proporcionan ubicaciones distintas de las de Google Maps?

A veces, el geocodificador de la API y el de Google Maps usan distintos conjuntos de datos (según el país). El codificador geográfico de la API, en ocasiones, se actualiza con datos nuevos, por lo que puedes esperar ver resultados que cambian o mejoran con el tiempo.

¿Qué formato deben tener mis consultas de codificación geográfica para maximizar la cantidad de solicitudes correctas?

El geocodificador está diseñado para mapear direcciones con coordenadas geográficas. Por lo tanto, te recomendamos que formatees las solicitudes que se envían al geocodificador de acuerdo con las siguientes pautas a fin de maximizar las probabilidades de que la consulta sea exitosa:

  • Especifica las direcciones de acuerdo con el formato utilizado por el servicio nacional de correos del país en cuestión.
  • No especifiques elementos de dirección adicionales, tales como nombres de las empresas o números de unidad, piso o apartamento que no estén incluidos en la dirección definida por el servicio de correos de ese país. Si lo haces, es posible que se generen respuestas con ZERO_RESULTS.
  • Formatea los códigos plus tal como se muestra aquí (para utilizarlos en la dirección URL, los signos más se convierten (se escapan) en %2B y los espacios en %20):
    • Un código global se compone de un código de área de 4 caracteres y un código local de 6 caracteres o más (849VCW8+R9 se convierte en 849VCWC8%2BR9).
    • Un código compuesto se compone de un código local de 6 caracteres o más con una ubicación explícita (CW8+R9 Mountain View, CA, EE.UU. se convierte en CWC8%2BR9%20Mountain%20View%20CA%20USA).
  • De ser posible, utiliza el número de calle de un sitio en lugar del nombre del edificio.
  • Utiliza direcciones con números de calle con preferencia a especificar calles transversales donde sea posible.
  • No proporciones "señales"', tales como puntos de referencia cercanos.
¿Cómo debo dar formato a una dirección de EE.UU. en una ruta numerada para su geocodificación?

El geocodificador de Google Maps Platform requiere que las rutas numeradas de EE.UU. se especifiquen en las direcciones de la siguiente manera:

  • Rutas del condado: "Co Road NNN", donde NNN es el número de la ruta, p. ej., "Co Road 82"
  • Autopistas estatales:"State NNN" donde State es el nombre completo del estado y NNN es el número de la autopista, p. ej., "California 82"
  • Autopistas de EE.UU.: "U.S. NNN", donde NNN es el número de la autopista, p. ej., "U.S. 101"
  • Autopistas interestatales de EE.UU.: "Interstate NNN", donde NNN es el número de la autopista interestatal, p. ej., "Interstate 280"
¿Cuándo debo usar una clase de geocodificador de la API y cuándo debo usar el servicio de geocodificación HTTP?

Consulta el documento Estrategias de geocodificación, que detalla las ventajas y desventajas de las distintas estrategias de geocodificación.

¿Cómo proporciono una ruta en auto con Google Maps Platform?

La API de Directions te permite brindar rutas en auto para viajes de uno o varios tramos. Las opciones de rutas te ayudan a brindar instrucciones sobre cómo llegar considerando un modo de viaje (en automóvil), una sola ruta o un conjunto de rutas y las restricciones que pudieran aplicarse (rutas sin peajes). El servicio está disponible en los siguientes formatos:

¿En qué países se encuentran disponibles las rutas en auto?

Para ver los países donde actualmente se admiten las rutas en auto en los productos de Google Maps Platform, consulta los datos de cobertura de Google Maps. Ten en cuenta que la disponibilidad de los datos de rutas en auto depende de nuestros contratos con proveedores de datos, por lo que está sujeta a cambio.

¿En qué países están disponibles las rutas en transporte público?

El servicio Directions de Google Maps, que incluye la API de Directions y la API de Distance Matrix, admite todos los proveedores de transporte público que figuran en la lista de cobertura de transporte público, excepto los de Japón.

¿Qué características KML y GeoRSS son compatibles con la API de Maps JavaScript?

La clase KmlLayer de la API de Maps JavaScript permite que los desarrolladores superpongan archivos KML/KMZ y GeoRSS sobre el mapa. Aquí puedes encontrar la documentación y ejemplos relacionados.

¿Cuáles son los límites de tamaño y complejidad de KML que se pueden mostrar con la clase KmlLayer de la API de Maps JavaScript?

Los límites de tamaño y complejidad en la visualización de KML con la clase KmlLayer están documentados aquí.

¿Cómo puedo renderizar en un mapa archivos KML que están alojados en sitios de intranet?

La clase KmlLayer, que genera superposiciones KML en la API de Maps JavaScript usa un servicio alojado por Google a fin de recuperar y analizar archivos KML para su renderización. Por eso, no es posible mostrar archivos KML que no estén alojados en una URL que esté disponible con acceso público o que requiera autenticación para acceder.

Si debes desarrollar aplicaciones que usen archivos KML alojados en sitios de intranet, te recomendamos representar el KML en el cliente usando bibliotecas de JavaScript de terceros. Dado que el navegador debe analizar el archivo KML, el rendimiento puede ser menor que cuando se usa la clase KmlLayer.

¿Cuál es la cantidad máxima de marcadores o vértices de ruta admitidos por la API de Maps Static?

No hay límites respecto de la cantidad de marcadores o vértices de ruta admitidos por la API de Maps Static. Cuando se usan íconos personalizados, se pueden especificar hasta cinco íconos únicos por solicitud, pero cada uno se puede usar múltiples veces dentro del mapa.

Ten en cuenta que las URL de la API de Maps Static pueden contener una cantidad máxima de aproximadamente 8,192 caracteres, lo cual restringe la cantidad de marcadores y vértices de rutas que se pueden especificar en función de la cantidad de lugares decimales que utilices al especificar cada par de latitud/longitud. Para obtener información sobre cómo la cantidad de decimales empleados se relaciona con la precisión en la Tierra, consulta el artículo de Wikipedia sobre grados decimales.

¿Por qué no puedo acceder a los productos de Google Maps Platform para ciertos países?

Las API de Google Maps no se pueden utilizar en Territorios prohibidos. Consulta también las Condiciones del Servicio.

¿Cómo informo un problema en el mapa base de Google?
Envíanos tus comentarios a través de Google Maps sobre la información incorrecta o faltante de un mapa, por ejemplo:
  • Direcciones o ubicaciones de los marcadores incorrectas
  • Nombres de rutas incorrectos
  • Información incorrecta sobre rutas de un solo sentido o de doble sentido
  • Trazado incorrecto de una ruta
  • rutas cerradas
  • Rutas inexistentes

Para corregir un lugar o una ficha de empresa, sugiere una edición.

Si el contenido de Maps debe quitarse por motivos legales, envía una solicitud legal.

Para solicitudes importantes o urgentes, crea un caso de ayuda con detalles específicos sobre lo que se debe corregir.

SDK de Google Maps para iOS

En Xcode 12, las apps no se compilan correctamente para el simulador. ¿Cómo puedo solucionar este problema?

Para solucionar este problema, abre la configuración de compilación de tu proyecto de Xcode y agrega arm64 a Excluded Architectures solo para compilaciones de "Simulador de iOS".

Para obtener más información, consulta la siguiente conversación sobre StackOverflow.

¿Cómo resuelvo el error kGMSPlacesRateLimitExceeded?
Si ves este error, es posible que estés usando una versión obsoleta del SDK de Places para iOS. La versión 2.7.0 del SDK de Places para iOS se desactivó y ya no está disponible. Actualiza tu app para usar la versión más reciente lo antes posible. Consulta la guía de migración para obtener más detalles.
Se producen fallas cuando realizo depuraciones con un dispositivo que tiene iOS 8.x. ¿Qué debo hacer?

Si tienes problemas cuando realizas depuraciones usando dispositivos con iOS 8.x, sigue estos pasos para inhabilitar la captura de marcos de GPU en el esquema XCode que ejecutes:

  1. En XCode, elige Product, Scheme y Manage Schemes.
  2. Selecciona un esquema y elige Edit....
  3. Configura la opción GPU Frame Capture como Disabled. Ten en cuenta que esta opción probablemente no esté presente en todos los dispositivos.
¿Cómo afectan las pantallas redondeadas y más anchas al SDK de Google Maps para iOS?

A partir del iPhone X, los iPhones tienen una forma de pantalla con esquinas redondeadas, una muesca en la parte superior del dispositivo, donde se aloja el sensor, y un indicador en la parte inferior de la pantalla para acceder a la pantalla principal. En el SDK para iOS 11.0, Apple agregó la API de Safe Area. Esto permite que los desarrolladores posicionen elementos en un área que resulta segura a fin de que no queden recortados por la nueva forma de pantalla.

El SDK de Google Maps para iOS tiene muchos controles y elementos visuales, como un selector de interiores y un vínculo para informar un problema. Con la versión 2.4, estos controles y elementos visuales podrían recortarse debido a la nueva forma de pantalla. En el modo de paisaje, el selector de pisos de interior podría verse recortado, ya sea por la muesca o por el indicador del botón de inicio.

Con la versión 2.5 del SDK de Google Maps para iOS, estos problemas de diseño se corrigen de forma automática. Cuando tu app se usa en un iPhone X o una versión posterior, el padding en GMSMapView y GMSPanoramaView aumenta para que los elementos visuales no se recorten.

Siempre incluiremos tu padding de forma predeterminada. El SDK de Google Maps para iOS supone que el padding está diseñado para usarse dentro del área segura. Si diseñas la interfaz partiendo del supuesto de que todo está posicionado dentro del área segura, esto funcionará sin esfuerzo adicional.

Si diseñaste una interfaz que no funciona con nuestro ajuste predeterminado, presentamos una nueva propiedad en GMSMapView, llamada paddingAdjustBehavior. GMSMapView ahora te permite elegir uno de los tres comportamientos de ajustes del padding: “Always” (predeterminado), “Automatic” (automático) y “Never” (nunca).

Si GMSMapView está configurado para usar el comportamiento de padding "Always", siempre agregará las inserciones del área segura al padding. Esto te permite diseñar tu interfaz partiendo del supuesto de que todo el contenido se posicionará dentro de los bordes del área segura. Este es el valor predeterminado.

Si GMSMapView está configurado para usar el comportamiento de padding "Automatic", siempre elegirá el espacio más grande, ya sea el padding o la inserción del área segura. Esto te permitirá agregar padding desde el borde de la pantalla y, al mismo tiempo, garantizar que todos los elementos permanezcan dentro del área segura.

Si GMSMapView está configurado para usar el comportamiento de padding "Never", nunca agregará las inserciones del área segura al padding. Este es el comportamiento anterior a la versión 2.5 y puede ser útil si tu padding ya tiene en cuenta el área segura o si los demás comportamientos que ofrecemos no funcionan bien con tu interfaz. Es tu responsabilidad asegurarte de que el logotipo de Google y los avisos sobre derechos de autor siempre estén visibles, tal como se especifica en las Condiciones del Servicio de Google Maps Platform.

En cambio, GMSPanoramaView no tiene una propiedad de padding opcional. Esto significa que no hay padding para ajustar y que GMSPanoramaView siempre aplicará el padding que sea necesario para garantizar que todos los elementos visuales queden dentro del área segura.

SDK de Google Maps para Android

¿Cómo resuelvo el error 9005 PLACES_API_RATE_LIMIT_EXCEEDED?
Si ves este error, es posible que estés usando una versión obsoleta del SDK de Places para Android. La versión de Servicios de Google Play del SDK de Places para Android se desactivó y ya no está disponible. Actualiza tu app para usar la versión más reciente lo antes posible. Consulta la guía de migración para obtener más detalles.

Firma de URL

¿Puedo firmar las URL usando JavaScript?

Recomendamos enfáticamente no firmar las URL usando JavaScript, ya que esto podría dejar expuesto tu secreto de firma de URL ante los usuarios finales. Por lo tanto, las firmas solo deben generarse a través de componentes del servidor.

¿Por qué recibo una respuesta “HTTP 403 Forbidden” a mis solicitudes de servicios web de las API de Google Maps?

Una respuesta HTTP 403 indica un problema de permisos, probablemente porque no se pudo verificar la firma para la solicitud en cuestión. Esto podría deberse a lo siguiente:

  1. Se especificó una firma, pero es incorrecta para esta solicitud.
  2. La solicitud especifica una clave de API del plan Premium de Google Maps Platform, pero no especifica una firma, y el servicio al que se llama exige que en todas las solicitudes realizadas con una clave de API se incluya una firma válida.
  3. Se especificó una firma, pero no se especificó la clave de API asociada del plan Premium de Google Maps Platform.