Parámetros de URL de la API de Maps JavaScript

En este documento, se analizan todos los parámetros que puedes especificar en la cadena de consulta de la URL de carga de la secuencia de comandos cuando cargas la API de Maps JavaScript. Algunos parámetros son obligatorios y otros son opcionales. Según indica el estándar para las URLs, todos los parámetros se separan con el carácter de Y comercial (&).

La siguiente URL de ejemplo tiene marcadores de posición para todos los parámetros posibles:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

La URL de la siguiente etiqueta script de ejemplo carga la API de Maps JavaScript:

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

Parámetros obligatorios

Los siguientes parámetros son obligatorios cuando se carga la API de Maps JavaScript.

  • key: Es tu clave de API. La API de Maps JavaScript no se cargará si no se especifica una clave de API válida.

  • callback: Es el nombre de una función global que se llamará una vez que la API de Maps JavaScript se cargue por completo.

Parámetros opcionales

Utiliza estos parámetros para solicitar una versión específica de la API de Maps JavaScript, cargar bibliotecas adicionales, localizar tu mapa o especificar la política de verificación de referente HTTP.

  • v: Indica la versión de la API de Maps JavaScript que se usará.

  • libraries: Incluye una lista separada por comas de bibliotecas adicionales de la API de Maps JavaScript que se cargarán.

  • language: Es el idioma que se usará. Esto afecta los nombres de los controles, los avisos sobre derechos de autor, las rutas en auto y las etiquetas de control, así como las respuestas a las solicitudes de servicio. Consulta la lista de idiomas disponibles.

  • region: Es el código de la región que se usará. Esto modifica el comportamiento del mapa según el país o el territorio determinados.

  • solution_channel: Google Maps Platform proporciona muchos tipos de códigos de muestra para ayudarte a comenzar rápidamente. Para realizar un seguimiento de la adopción de nuestras muestras de código más complejas y mejorar la calidad de las soluciones, Google incluye el parámetro de consulta solution_channel en las llamadas a la API en nuestro código de muestra.

  • auth_referrer_policy: Los clientes de Maps JS pueden configurar restricciones de URLs de referencia HTTP en la consola de Cloud para limitar las URLs que pueden usar una clave de API en particular. De forma predeterminada, estas restricciones se pueden configurar para permitir que solo ciertas rutas de acceso usen una clave de API. Si una URL con el mismo origen o dominio puede usar la clave de API, puedes configurar auth_referrer_policy=origin para limitar la cantidad de datos que se envían cuando se autorizan solicitudes de la API de Maps JavaScript. Esta función está disponible a partir de la versión 3.46. Cuando se especifica este parámetro y se habilitan las restricciones de URLs de referencia HTTP en la consola de Cloud, la API de Maps JavaScript solo podrá cargarse si hay una restricción de URLs de referencia HTTP que coincida con el dominio del sitio web actual sin una ruta especificada.