Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar la Google Maps JavaScript API

Para que puedas comenzar, te proporcionaremos orientación en la Google Developers Console a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar la Google Maps JavaScript API y servicios relacionados
  3. Crear claves correspondientes
Continuar

Localizar el mapa

Puedes personalizar tu 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 conforme a un país o territorio determinado.

Localización de idiomas

De forma predeterminada, la Google Maps JavaScript API usa la configuración de idioma preferida por el usuario y especificada en el navegador al mostrar información con texto, 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. No obstante, si deseas que la Maps JavaScript API ignore la configuración de idioma del navegador, puedes hacer que muestre forzosamente información en un idioma específico agregando un parámetro language a la etiqueta <script> cuando se cargue el código de la Maps JavaScript API.

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

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

Ver el ejemplo.

Si configuras el idioma del mapa, es importante que consideres configurar también 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 Maps JavaScript API 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. Entre los ejemplos de idiomas RTL se incluyen el árabe, el hebreo y el farsi. Generalmente, debes aplicar especificaciones a las páginas en idiomas RTL para que se representen en forma adecuada agregando dir='rtl' al elemento <html> de estas. En el siguiente ejemplo se representa un mapa de El Cairo, Egipto, con controles en árabe:

<!DOCTYPE html>
<html dir="rtl">
  <body>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar&region=EG">
    </script>
  </body>
</html>

Ver el ejemplo.

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

Localización de regiones

Cuando cargues la Google Maps JavaScript API desde maps.googleapis.com, aplicará una restricción predeterminada al comportamiento de la aplicación respecto de Estados Unidos. Si deseas modificar tu aplicación para que se usen mosaicos de mapas diferentes o se apliquen restricciones (como las de resultados de geocodificación en la región), puedes anular este comportamiento predeterminado agregando un parámetro region a la etiqueta <script> cargando el código de la Maps JavaScript API.

Como desarrollador de una aplicación con la Maps JavaScript API, tienes la responsabilidad de garantizar que tu aplicación cumpla con las leyes locales asegurándote de 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 región Unicode, los cuales (en general) tienen una asignación uno a uno a dominios de nivel superior de código de país (ccTLD). La mayoría de los identificadores de región Unicode son idénticos a códigos ISO 3166-1 y existen algunas excepciones marcadas. Por ejemplo, el ccTLD de Gran Bretaña es “uk” (correspondiente al dominio .co.uk) mientras que su identificador de región es “GB”.

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

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

En los siguientes ejemplos se muestran dos mapas: uno con geocódigos “Toledo” según la región predeterminada (EE. UU.) para “Toledo, Ohio” y uno que restringe resultados conforme a un parámetro region establecido en ES (España) para “Toledo, España”.

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

Cómo cargar la API en China

La Google Maps JavaScript API se ofrece en China desde http://maps.google.cn. Al ofrecer contenido para China, reemplaza https://maps.googleapis.com por http://maps.google.cn. Por ejemplo:

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY">
</script>

Si te orientas específicamente a usuarios de China, también debes agregar los parámetros de región e idioma. La API admite zh-CN y zh-TW como valores para el parámetro language.

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY">
</script>

Enviar comentarios sobre...

Google Maps JavaScript API
Google Maps JavaScript API
Si necesitas ayuda, visita nuestra página de asistencia.