Localiza el mapa

Para personalizar tu mapa en función de un país o una región específicos, puedes hacer lo siguiente:

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

Localización de idiomas

De forma predeterminada, la API de Maps JavaScript usa la configuración de idioma de preferencia del usuario según lo que se especifica en su navegador al mostrar información textual, como los nombres de los controles, los avisos sobre derechos de autor, las rutas en auto y las etiquetas de los 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 forzarla para que muestre la información en un idioma específico. Para ello, agrega un parámetro language a <script> cuando cargues el código de la API de Maps JavaScript.

El parámetro language afecta los nombres de los controles, los avisos sobre derechos de autor, las rutas en auto y las etiquetas control, así como las respuestas a las solicitudes de servicio. El impacto en los servicios no es tan evidente. Por ejemplo, cuando se geocodifican 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 se indica en función de la ubicación que geocodificas. Por otro lado, los resultados a nivel político y postal 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&loading=async&region=JP&language=ja&callback=initMap">
</script>

Ver ejemplo

Si configuras el idioma del mapa, también es importante que configures la región. Esto te permitirá asegurarte de que tu aplicación cumpla con las leyes locales.

Nota: Si cargas la API como se muestra 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 caracteres de texto bidireccional (Bidi) en idiomas con escritura de izquierda a derecha (LTR) y de derecha a izquierda (RTL) de forma nativa. Entre los ejemplos de idiomas RTL, se incluyen el árabe, el hebreo y el farsi. En general, es necesario especificar las páginas en idiomas RTL para renderizarlas correctamente. Para ello, agrega 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&loading=async&region=EG&language=ar&callback=initMap">
</script>

Ver ejemplo

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

Localización regional

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

Como desarrollador de una aplicación que usa la API de Maps JavaScript, se te recomienda que siempre establezcas un parámetro region, ya que varios servicios (como Place Autocomplete) suelen proporcionar mejores resultados cuando se define region. También es tu responsabilidad asegurarte de que tu aplicación cumpla con las leyes locales para lo cual debes comprobar que se aplique la localización regional correspondiente el país en el que esta se aloja.

El parámetro region acepta identificadores de subetiquetas regionales de Unicode que, en general, tienen una asignación uno a uno con los dominios de nivel superior con código de país (ccTLD). La mayoría de los identificadores regionales de Unicode son idénticos a los códigos ISO 3166-1 alfa-2, con algunas excepciones notables. Por ejemplo, el ccTLD de Gran Bretaña es "uk" (correspondiente al dominio .co.uk), mientras que su identificador regional 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&loading=async&region=GB&callback=initMap">
</script>

En los siguientes ejemplos, se muestran dos mapas: uno que geocodifica "Toledo" como "Toledo, Ohio" basándose en el parámetro region establecido en US (EE.UU.) y otro que restringe los resultados a "Toledo, España" basándose en el parámetro region establecido en ES (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 sobre cómo cargar el mapa con el idioma y la región que prefieras.

Mira esta demostración en pantalla completa.