Solución de problemas

Recordatorio: Para usar la API de Maps JavaScript, ten en cuenta lo siguiente:

• Todas las solicitudes a la API de Maps JavaScript deben incluir una clave de API. Ya no admitimos el acceso sin clave.
• Debes habilitar la facturación en cada uno de tus proyectos.

Errores de la clave de API y la facturación

En determinadas 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 "solo para fines de desarrollo". Este comportamiento generalmente indica que hay problemas con una clave de API o la facturación. Para usar los productos de Google Maps Platform, debes tener la facturación habilitada en tu cuenta y todas las solicitudes deben incluir una clave de API válida. El siguiente flujo de preguntas y respuestas te ayudará a solucionar el problema:

¿Estás usando una clave de API?

No lo sé. ¿Cómo puedo comprobar si estoy usando una clave de API?

Una clave de API se pasa como el parámetro key en la URL que se utiliza para cargar la API de Maps JavaScript. A continuación, se muestran algunas opciones que puedes usar para verificar si estás usando una clave de API:

• Usa la extensión de Chrome Google Maps Platform API Checker. Esto te permite determinar si tu sitio web implementa adecuadamente las APIs de Google Maps con licencia ofrecidas por Google.
• Si usas una biblioteca o un complemento para cargar la API de Maps JavaScript, comprueba la configuración de esa biblioteca y busca una opción de clave de API.
• Revisa los errores en el navegador. Si ves los siguientes mensajes, significa que no estás usando tu clave de API correctamente:
• Advertencia de la API de Maps JavaScript de Google: NoApiKeys
• Error de la API de Maps JavaScript de Google: MissingKeyMapError

Para desarrolladores web:

• Si tienes acceso al código fuente de tu aplicación, busca la etiqueta <script> que se usa para cargar la API de Maps JavaScript. Cuando cargues esta API, en el código que se muestra a continuación, reemplaza YOUR_API_KEY con tu clave de API.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>
  

• Verifica el tráfico de red que genera tu sitio web en el navegador. En Chrome, puedes ver esta información en la pestaña Network de las Herramientas para desarrolladores. Aquí podrás ver las solicitudes de red que realizó tu sitio web. Las solicitudes realizadas con la API de Maps JavaScript se encontrarán en la ruta de acceso maps/api/js. Aquí puedes confirmar si las solicitudes usan el parámetro key. Puede resultarte útil filtrar el tráfico de red por maps/api/js cuando visualizas la pestaña Network.

No, no estoy usando una clave de API.

Para obtener una clave de API, haz clic en el siguiente botón. Si no ves una configuración guiada, sigue las instrucciones completas que se detallan en Cómo comenzar a utilizar Google Maps Platform.
Comenzar

Sí, estoy usando una clave de API.

¡Perfecto! Ahora, veamos si hay una cuenta de facturación vinculada a tu proyecto.

¿Hay una cuenta de facturación vinculada a tu proyecto?

No lo sé. ¿Cómo puedo comprobar si hay una cuenta de facturación vinculada a mi proyecto?

Ve a la página Facturación en Google Cloud Console y selecciona el proyecto en el que se creó tu clave de API. Para confirmar que la clave está asociada al proyecto, haz lo siguiente:

1. Ve a la sección Credenciales, accesible desde la barra lateral izquierda en Google Maps Platform > Credenciales.
2. Comprueba que aparezca la clave de API que actualmente usas en tu sitio web. Si no figura, cambia a otro proyecto y verifica las credenciales allí.
3. Si no encuentras el proyecto que corresponde a tu clave de API, es posible que hayas perdido el acceso a ese proyecto. Pídeles ayuda a otros miembros de tu organización. Si no se puede encontrar el proyecto original, haz lo siguiente:
   1. Crea un nuevo proyecto. Para ello, selecciona Proyecto nuevo en la lista de proyectos o Crear proyecto en la página Administrador de recursos.
   2. Crea una nueva clave de API. Puedes hacerlo en la página Credenciales. Una vez ahí, haz clic en Crear credenciales y selecciona Clave de API.

Cuando hayas localizado tu proyecto en Cloud Console, comprueba si tiene vinculada una cuenta de facturación. Para ello, navega hasta la sección Facturación en el menú lateral izquierdo.

No, no hay ninguna cuenta de facturación vinculada a mi proyecto.

Ve a la página Habilitar facturación en Cloud Console y agrega una cuenta de facturación a tu proyecto. Para obtener información adicional, consulta Cómo comenzar a utilizar Google Maps Platform.

Sí, hay una cuenta de facturación vinculada a mi proyecto.

¡Perfecto! Ahora, comprobemos si el método de facturación proporcionado es válido.

¿Dejó de ser válido el método de facturación proporcionado (por ejemplo, una tarjeta de crédito vencida)?

Puedes agregar, quitar o actualizar una forma de pago en Cloud Console.

¿Existe un límite diario autoimpuesto para la API?

Si estableciste un límite diario en alguna de las APIs, lo cual es común para evitar aumentos inesperados, puedes aumentar dicho límite para solucionar este problema.

Si deseas verificar tus límites diarios, ve al panel de APIs y servicios en la consola de Cloud. Una vez allí, haz lo siguiente:

1. Si se te solicita, selecciona un proyecto.
2. Selecciona una API de la lista y, luego, haz clic en la pestaña Cuotas.

¿Tu clave de API tiene una restricción de direcciones IP?

Las claves de API con una restricción de direcciones IP solo se pueden utilizar con los servicios web diseñados para usarse desde el servidor (como la API de Geocoding y otras APIs de servicios web). La mayoría de estos servicios web tienen servicios equivalentes dentro de la API de Maps JavaScript (por ejemplo, consulta el Servicio de geocodificación). Para usar los servicios del cliente de la API de Maps JavaScript, deberás crear una clave de API separada que pueda protegerse con una restricción de URLs de referencia de HTTP (consulta Cómo obtener, agregar y restringir una clave de API).

Si tu código no funciona:

Para ayudarte a lograr que tus códigos de mapas funcionen, Brendan Kenny y Mano Marks señalan algunos errores comunes y cómo corregirlos en este video.

• Busca errores de ortografía. Recuerda que JavaScript es un lenguaje que distingue mayúsculas de minúsculas.
• Verifica los puntos básicos. Algunos de los problemas más comunes se producen en el momento inicial de la creación de mapas. Por ejemplo:
  • Confirma si especificaste las propiedades zoom y center en las opciones del mapa.
  • Asegúrate de haber declarado un elemento div según el cual el mapa aparecerá en la pantalla.
  • Asegúrate de que se haya especificado una altura para el elemento div del mapa. De manera predeterminada, los elementos div se crean con una altura de 0, por lo que son invisibles.
  Consulta nuestros ejemplos para obtener una implementación de referencia.
• Usa un depurador de JavaScript para identificar problemas, como el que está disponible en las herramientas para desarrolladores de Chrome. Primero busca errores en la Consola de JavaScript.
• Publica tus preguntas en Stack Overflow. Los lineamientos para publicar preguntas de calidad están disponibles en la página de asistencia.