Localizar el mapa

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Puedes personalizar el mapa para un país o una región específicos de las siguientes maneras:

  • Cambia la configuración de idioma predeterminada.
  • Especifica un código de región que altere el comportamiento del mapa en función de un país o territorio determinado.

Localización de idiomas

De forma predeterminada, la API de Maps JavaScript usa la configuración de idioma preferida por el usuario y especificada en el navegador al mostrar información textual, como los nombres de controles, los avisos de derechos de autor, las indicaciones de manejo y las etiquetas de mapas. En la mayoría de los casos, es preferible respetar la configuración del navegador. Sin embargo, si deseas que la API de Maps JavaScript ignore la configuración de idioma del navegador, puedes hacer que muestre información en un idioma específico. Para ello, agrega un parámetro language a la etiqueta <script> cuando cargues el código de la API de Maps JavaScript.

El parámetro language afecta los nombres de los controles, los avisos de derechos de autor, las instrucciones sobre cómo llegar y las etiquetas de control, así como las respuestas a las solicitudes de servicio. El efecto en los servicios no es tan evidente. Por ejemplo, cuando se realiza la geocodificación de direcciones a nivel de la calle, el nombre del país se muestra en el idioma que solicitaste, pero el resto de la dirección será específica de la ubicación que codificas geográficamente. Por otro lado, los resultados políticos y postales se muestran en el idioma solicitado. Prueba esta demostración para experimentar con los cambios en el mapa cuando actualices el parámetro language.

En el siguiente ejemplo, se muestra un mapa en japonés y se establece la región en Japón:

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

Ver el ejemplo.

Si configuras el idioma del mapa, también debes establecer la región. Esto ayuda a garantizar que tu aplicación cumpla con las leyes locales.

Nota: Cuando cargas la API como se muestra más arriba, el mapa usa el idioma japonés para todos los usuarios, independientemente de las preferencias del usuario. Asegúrate de que este sea el comportamiento que deseas antes de configurar esta opción.

La API de Maps JavaScript también admite texto bidireccional (Bidi) que contenga caracteres en idiomas con orientación de izquierda a derecha (LTR) y derecha a izquierda (RTL) de forma nativa. Algunos ejemplos de idiomas RTL incluyen el árabe, el hebreo y el farsi. En general, debes especificar páginas de idiomas con escritura de derecha a izquierda para procesarlas correctamente agregando dir='rtl' al elemento <html> de la página. En el siguiente ejemplo, se muestra un mapa de El Cairo, Egipto, con controles en árabe:

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

Ver ejemplo

Consulta la lista de idiomas compatibles. Ten en cuenta que se agregan nuevos idiomas con frecuencia, por lo que es posible que esta lista no sea exhaustiva.

Localización de regiones

Agrega un parámetro region a la etiqueta <script> cuando cargues el código de la API de Maps JavaScript si deseas modificar tu aplicación para que se muestren mosaicos de mapas diferentes o sesgar la aplicación (por ejemplo, restringir los resultados de la geocodificación hacia la región).

Como desarrollador de una aplicación con la API de Maps JavaScript, se recomienda que siempre establezcas un parámetro region, ya que varios servicios (como Place Autocomplete) suelen proporcionar mejores resultados cuando se establece region. También es tu responsabilidad asegurarte de que tu aplicación cumpla con las leyes locales al garantizar que se aplique la localización de regiones adecuada del país en el que se aloja la aplicación.

El parámetro region acepta identificadores de subetiquetas de la región Unicode que (en general) tienen una asignación uno a uno a los dominios de nivel superior con códigos de país (ccTLD). La mayoría de los identificadores de región Unicode son idénticos a códigos ISO 3166-1 alpha-2, con algunas excepciones notables. Por ejemplo, el ccTLD de Gran Bretaña es “uk” (correspondiente al dominio .co.uk) mientras que el identificador de región es “GB”. Consulta los detalles de cobertura de Google Maps Platform para conocer las regiones admitidas. Prueba esta demostración para experimentar con los cambios en el mapa cuando actualices el parámetro region.

Por ejemplo, la siguiente etiqueta de secuencia de comandos localiza el mapa en el Reino Unido:

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

En los siguientes ejemplos, se muestran dos mapas: uno con geocódigos (Toledo) basado en un region (US) configurado como US (EE.UU.) y uno de Toledo (Ohio) y otro (Sesgo) (ES), que corresponde a uno de &Tododo (España).

Consulta el ejemplo de EE.UU. y el ejemplo de ES.

Demostración de localización

Al configurar el idioma del mapa, también es importante establecer la región. A continuación, te mostramos una demostración que te permite cargar el mapa con el idioma y la región que prefieras.

Mira esta demostración en pantalla completa.