Autenticación y autorización

Esta página está destinada únicamente a clientes con una licencia anterior de Maps APIs for Work o Maps API for Business. Esta página no está destinada a clientes con el nuevo Google Maps APIs Premium Plan, que se encuentra disponible desde enero de 2016.

ID de cliente

Para autenticar Google Maps JavaScript API para clientes de Google Maps APIs for Work, es necesario contar con un ID de cliente exclusivo y registrar la URL.

Obtener un ID de cliente

Para acceder a las funciones especiales de Google Maps APIs for Work, debes proporcionar un ID de cliente al acceder a cualquiera de los servicios o las bibliotecas de API. Cuando te registres para Google Maps APIs for Work, recibirás este ID de cliente del Google Cloud Support Portal. 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 for Work no se contemplan las aplicaciones que usan la versión experimental.

Registrar tus 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á 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 implementaciones de Google Maps APIs for Work.