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

Obtener una clave o autenticación

Todas las aplicaciones de Google Maps JavaScript API requieren autenticación.

  • Usuarios de la API estándar: si usas la API con el plan estándar, debes emplear una clave de API configurada en el proyecto que elijas. Consulta más información sobre las claves de API para la API estándar.
  • Usuarios de la Premium Plan: si usas la API con el Google Maps APIs Premium Plan, existen dos métodos de autenticación.
    • Usa una clave de API configurada en el proyecto de Google Maps APIs Premium Plan (creada cuando compraste Premium Plan).
        
    • Usa tu ID de cliente en lugar de la clave de API.

    Consulta la sección de Google Maps APIs Premium Plan, a continuación, para obtener información sobre cómo elegir el mejor método de autenticación.

Autenticación para la API estándar: claves de API

Para usar la API estándar, debes incluir una clave de API cuando cargues la API.

Beneficios de usar una clave de API:

  • La clave de API te permite controlar el uso de la API por parte de tu aplicación en Google API Console. Para obtener más información, consulta la ayuda de la Google API Console.
  • Con una clave, tienes acceso a una cuota diaria gratuita generosa y la opción de aumentar tu cuota diaria si activas la facturación de pago según el uso.
  • Registrar una clave de API garantiza que Google pueda comunicarse contigo por temas relacionados con tu aplicación, si fuera necesario.

Obtén una clave de API

Para comenzar a usar Google Maps JavaScript API, haz clic en el botón que aparece a continuación, que te guiará por todo el proceso de activación de Google Maps JavaScript API, y de cualquier servicio relacionado, de forma automática.

Obtener una clave

También puedes seguir estos pasos para obtener una clave de API:

  1. Ingresa a Google API Console.
  2. Crea o selecciona un proyecto.
  3. Haz clic en Continue para habilitar la API y cualquier servicio relacionado.
  4. En la página Credentials, obtén una clave de API (y configura las restricciones para esta).
    Nota: Si ya tienes una clave de API sin restricciones o una clave con restricciones de navegador, puedes usarla.
  5. Para evitar el robo de cuota, protege tu clave de API siguiendo estas prácticas recomendadas.
  6. (Opcional) Habilita la facturación. Para obtener más información, consulta Límites de uso.


En la Google API Console, también puedes buscar una clave existente o ver una lista de las API habilitadas.

Para obtener más información sobre el uso de la Google API Console, consulta Ayuda de la API Console.

Tipos de restricciones de clave de API

Las Google Maps API están disponibles para apps de Android o iOS y navegadores web, y a través de servicios web HTTP. Las API de cualquier plataforma pueden usar una clave de API genérica (sin restricciones). También puedes agregar una restricción (por ejemplo, un origen de referencia de HTTP) a la clave de API. Una vez restringida, la clave solo funcionará en plataformas que admitan ese tipo de restricción. Obtén más información sobre claves y credenciales.

Especificar una clave cuando se carga la API

Para especificar una clave, inclúyela como valor de un parámetro key cuando se cargue la API.

Por ejemplo:

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

Autenticación para clientes de Google Maps APIs Premium Plan

La información de esta sección corresponde solamente al nuevo Google Maps APIs Premium Plan, que se encuentra disponible desde el 6 de enero de 2016.

¿Tienes una licencia anterior de Maps APIs for Work o de Maps API for Business? Consulta nuestra guía sobre licencias de Maps APIs for Work. Para determinar si tienes una licencia anterior: en el Google Cloud Support Portal, haz clic en Maps: Usage Report a la izquierda. Si el ID de la parte superior del informe se encuentra en el siguiente formato, contarás con el nuevo Premium Plan:
gme-[empresa] & proj-[número] ([tipo])
. De lo contrario, tu licencia será más antigua.

Cuando uses Google Maps JavaScript API con una licencia Google Maps APIs Premium Plan, debes autenticar tu aplicación con una clave de API o un ID de cliente. Nota: Si ya cuentas con una licencia anterior de Maps API for Business, debes usar un ID de cliente y no una clave de API.

Cuando debas decidir el método de autenticación, ten en cuenta lo siguiente:

  • La clave de API (disponible para clientes de Google Maps APIs Premium Plan, pero no para quienes ya tengan una licencia de Maps API for Business). Si usas una clave de API para autenticar solicitudes, puedes hacer lo siguiente:
  • El ID de cliente. Si usas tu ID de cliente (en lugar de la clave de API) para autenticar solicitudes, puedes hacer lo siguiente:
    • agregar el parámetro channel a las solicitudes para poder ver informes de uso más completos;
    • ver informes de uso con más de 30 días de datos en el Google Cloud Support Portal.
    • usar herramientas de Maps Analytics para Maps JavaScript API.

Obtén más información sobre los informes disponibles para clientes de Premium Plan.

Usar una clave de API

Para autenticar Google Maps JavaScript API con una clave de API, haz clic en el botón que aparece a continuación, que te guiará por todo el proceso de obtención de una clave de API.

Importante: En el menú desplegable del proyecto, asegúrate de seleccionar el proyecto que se creó cuando adquiriste el Premium Plan. El nombre del proyecto comienza con Google Maps APIs for Business or Google Maps for Work or Google Maps.

Obtener una clave

También puedes seguir estos pasos para obtener una clave de API:

  1. Ingresa a Google API Console.
  2. En el menú desplegable Project, selecciona el proyecto Google Maps Premium.*
  3. Haz clic en Continue.
  4. En la página Credentials, obtén una clave de API (y configura las restricciones para esta).
    Nota: Si ya tienes una clave de API sin restricciones o una clave con restricciones de navegador, puedes usarla.
  5. Para evitar el robo de cuota, protege tu clave de API siguiendo estas prácticas recomendadas.

* Nota: En el menú desplegable de proyectos, debes seleccionar el proyecto que se creó para ti cuando compraste Premium Plan. El nombre del proyecto comienza con Google Maps APIs for Business or Google Maps for Work or Google Maps. Importante: Si ya cuentas con una licencia anterior de Maps API for Business, debes usar un ID de cliente y no una clave de API.


También puedes buscar una clave existente en Google API Console.

Para obtener más información sobre el uso de la Google API Console, consulta Ayuda de la API Console.

Especificar una clave cuando se carga la API

Para especificar una clave, inclúyela como valor de un parámetro key cuando se cargue la API.

Por ejemplo:

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

Usar un ID de cliente

Para autenticar Google Maps JavaScript API con un ID de cliente (en lugar de una clave de API), será necesario contar con un ID de cliente exclusivo y registrar la URL.

Si antes usabas una clave de API para la autenticación, pero ahora deseas usar un ID de cliente, debes quitar el parámetro key antes de cargar la API. La carga de la API fallará si se incluye el ID de cliente y la clave de API.

Tu ID de cliente

Cuando adquieras tu licencia de Google Maps APIs Premium Plan, Google te enviará un correo electrónico de bienvenida con tu ID de cliente. El ID de cliente se usa para poder acceder a las funciones especiales de Google Maps APIs Premium Plan. Todos los ID de cliente comienzan con un prefijo gme-.

El ID de cliente no es una clave. Solo funcionará en las URL que autorices. Por ello, no deberás preocuparte por mantenerlo en secreto.

Especificar un ID de cliente al cargar la API

Especifica tu ID de cliente como valor del parámetro client cuando se cargue la Google Maps JavaScript API:

<script async defer src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID &v=3.26&callback=initMap"></script>

Como se muestra en este ejemplo, debes anexar un parámetro v=3.26 para especificar la versión de lanzamiento (también citada como “versión con funciones estables”) o una versión anterior. En el SLA de Google Maps APIs Premium Plan no se contemplan las aplicaciones que usan la versión experimental.

Registrar URL autorizadas

Para evitar que otros usen tu ID de cliente en su sitio web, el uso de tu ID de cliente se limita a una lista de URL que autorizas de manera específica.

Para ver las URL que ya autorizaste o para autorizar más, realiza lo siguiente:

  1. Accede al Google Cloud Support Portal.
  2. En el menú de la izquierda, haz clic en Maps: Manage Client ID.

Puedes agregar hasta 100 URL al mismo tiempo. En total, puedes agregar 3000. Si necesitas agregar más, comunícate con el sector de asistencia.

Se deben tener en cuenta las siguientes consideraciones para las URL autorizadas:

El nombre del dominio o la dirección IP no deben ser de acceso público.
Por ejemplo, http://myintranet y http://192.168.1.1 son entradas válidas.
También se autorizan todos los subdominios de un dominio especificado.
Por ejemplo, si se autorizó http://example.com, también se autorizará a http://www.example.com. Sin embargo, no sucede lo contrario: si se autoriza http://www.example.com, no significa que se autorice http://example.com.
También se autorizan todos los elementos de una ruta de acceso autorizada.
Por ejemplo, si se autorizó http://example.com, también se autoriza http://example.com/foo. Además, debido a que se autorizan los subdominios de un dominio especificado, también se autoriza http://sub.example.com/bar.
Para las rutas de acceso, se distinguen mayúsculas y minúsculas.
Por ejemplo, http://www.example.com/ThisPath/ no es lo mismo que http://www.example.com/thispath/.
Puedes restringir URL válidas según el puerto que usen.
Por ejemplo, si se especificó http://example.com:8080/foo, no significa que http://example.com esté autorizada.
Los protocolos HTTP y HTTPS se consideran como URL distintas.
Por ejemplo, si se autoriza https://example.com, no significa que también se autorizó http://example.com. Si deseas autorizar las dos al mismo tiempo, puedes agregar un dominio sin usar un protocolo: example.com/.

Todas las reglas descritas anteriormente se aplican a cada autorización. Por lo tanto, debes planificar con cuidado las autorizaciones. Por ejemplo, dado que se autorizan todos los elementos de una ruta de acceso especificada y todos los subdominios, es posible que autorices páginas que no tenías previstas. Por ejemplo:

Junto a http://example.com/ también se autoriza http://sub.example.com/path.

Para obtener más información, consulta Solución de problemas de autorización en Google Maps APIs Premium Plan.

Enviar comentarios sobre...

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