Class Maps

Maps

Permite encontrar direcciones, realizar geocodificación, tomar muestras de elevación y crear imágenes de mapas estáticos.

Propiedades

Propiedad	Tipo	Descripción
DirectionFinder	DirectionFinderEnums
StaticMap	StaticMapEnums

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
decodePolyline(polyline)	Number[]	Decodifica una cadena de polilínea codificada en un array de puntos.
encodePolyline(points)	String	Codifica un array de puntos en una cadena.
newDirectionFinder()	DirectionFinder	Crea un objeto DirectionFinder nuevo.
newElevationSampler()	ElevationSampler	Crea un objeto ElevationSampler.
newGeocoder()	Geocoder	Crea un objeto Geocoder nuevo.
newStaticMap()	StaticMap	Crea un objeto StaticMap nuevo.
resetAuthenticationApiKey()	void	Restablece las credenciales de autenticación para usar las asignaciones de cuota predeterminadas.
setAuthenticationByApiKey(apiKey)	void	Permite el uso de una clave de API para autenticar solicitudes y aprovechar cuotas adicionales.
setAuthenticationByApiKey(apiKey, signingKey)	void	Permite el uso de una clave de API y una clave de firma para autenticar solicitudes y aprovechar cuotas adicionales en StaticMap.

Métodos obsoletos

Método	Tipo de datos que se devuelve	Descripción breve
setAuthentication(clientId, signingKey)	void	Permite el uso de una cuenta del plan Premium de las APIs de Google Maps establecida de forma externa para aprovechar las asignaciones de cuota adicionales.

Documentación detallada

decodePolyline(polyline)

Decodifica una cadena de polilínea codificada en un array de puntos.

// Decodes a string representation of the latitudes and longitudes of
// Minneapolis and Milwaukee respectively.
const polyline = 'qvkpG`qhxPbgyI_zq_@';
const points = Maps.decodePolyline(polyline);
for (let i = 0; i < points.length; i += 2) {
  Logger.log('%s, %s', points[i], points[i + 1]);
}

Parámetros

Nombre	Tipo	Descripción
polyline	String	Una polilínea codificada para decodificar.

Volver

Number[] : Un array de pares de latitud y longitud (lat0, long0, lat1, long1, ...).

Consulta también

• Formato de polilínea codificada

---

encodePolyline(points)

Codifica un array de puntos en una cadena.

// The latitudes and longitudes of New York and Boston respectively.
const points = [40.77, -73.97, 42.34, -71.04];
const polyline = Maps.encodePolyline(points);

Parámetros

Nombre	Tipo	Descripción
points	Number[]	Un array de pares de latitud y longitud para codificar.

Volver

String : Una cadena codificada que representa esos puntos.

Consulta también

• Formato de polilínea codificada

---

newDirectionFinder()

Crea un objeto DirectionFinder nuevo.

Volver

DirectionFinder : Un objeto nuevo de búsqueda de direcciones.

---

newElevationSampler()

Crea un objeto ElevationSampler.

Volver

ElevationSampler : Un objeto nuevo de muestreo de elevación.

---

newGeocoder()

Crea un objeto Geocoder nuevo.

Volver

Geocoder : Un objeto nuevo de geocodificador.

---

newStaticMap()

Crea un objeto StaticMap nuevo.

Volver

StaticMap : Un objeto nuevo de mapa estático.

---

resetAuthenticationApiKey()

Restablece las credenciales de autenticación para usar las asignaciones de cuota predeterminadas. Este método funciona cuando usas la clave de API para autenticar solicitudes. Puedes usar este método para volver a las asignaciones de cuota predeterminadas si deseas usar los métodos Maps sin proporcionar credenciales de autenticación.

Maps.resetAuthenticationApiKey();

Arroja

Error : Si se usa setAuthentication(clientId, signingKey) para la autenticación.

---

setAuthenticationByApiKey(apiKey)

Permite el uso de una clave de API para autenticar solicitudes y aprovechar cuotas adicionales.

Este método se usa para establecer una clave de API que se usa para autenticar solicitudes. Cuando se llama a este método, el consumo de cuota y la facturación se cargan al proyecto de Google Cloud asociado con la clave de API proporcionada según la hoja de precios. Puedes usar los métodos Maps con las asignaciones de cuota predeterminadas sin proporcionar credenciales de autenticación. Si usas StaticMap, usa el método setAuthenticationByApiKey(apiKey, signingKey) en su lugar.

Nota: Si usas el ID de cliente para autenticar solicitudes, ten en cuenta que el ID de cliente se dio de baja el 26 de mayo de 2025 y ya no se podrá usar después del 31 de mayo de 2026. En lugar de usar un ID de cliente, debes usar credenciales de clave de API para autenticar el tráfico de tu servicio de la API de Google Maps. Para obtener más detalles, consulta la guía.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parámetros

Nombre	Tipo	Descripción
apiKey	String	Una clave de API que se puede obtener de la consola de Google Cloud siguiendo los pasos que se mencionan en la guía de inicio rápido.

Arroja

Error : Si apiKey es null o si setAuthentication(clientId, signingKey) ya se usa para la autenticación.

---

setAuthenticationByApiKey(apiKey, signingKey)

Permite el uso de una clave de API y una clave de firma para autenticar solicitudes y aprovechar cuotas adicionales en StaticMap. Si bien se requiere signingKey para las solicitudes a la API de Static Map, este método también se puede usar para autenticar otros servicios de Maps. En esos casos, se ignora el parámetro signingKey.

Este método se usa para establecer una clave de API y una clave de firma que se usan para autenticar solicitudes. Se requiere una clave de firma para StaticMap, ya que acepta una pequeña cantidad de solicitudes sin firma para fines de prueba, pero comienzan a fallar una vez que alcanza el umbral en tu producción. Puedes obtener más detalles aquí.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0',
'7_pry-Skg0PKxds-7nvdl91mB5=');

Parámetros

Nombre	Tipo	Descripción
apiKey	String	Una clave de API que se puede obtener de la consola de Google Cloud siguiendo los pasos que se mencionan en la guía de inicio rápido.
signingKey	String	Una clave de firma que se puede obtener de la consola de Google Cloud siguiendo los pasos que se mencionan en la guía de firma digital. Esto es obligatorio para StaticMap y se ignora para otros servicios de Maps servicios.

Arroja

Error : Si apiKey es null o si setAuthentication(clientId, signingKey) ya se usa para la autenticación.

Consulta también

• setAuthenticationByApiKey(apiKey)

Métodos obsoletos

setAuthentication(clientId, signingKey)

Obsoleto. En su lugar, usa setAuthenticationByApiKey(apiKey), que usa la clave de API para la autenticación.

Permite el uso de una cuenta del plan Premium de las APIs de Google Maps establecida de forma externa para aprovechar las asignaciones de cuota adicionales. Tu ID de cliente y clave de firma se pueden obtener en la sección Maps de la consola de Google Cloud. Establece estos valores en null para volver a usar las asignaciones de cuota predeterminadas.

Nota: Este método no funciona con claves de API. Además, ten en cuenta que el plan Premium ya no está disponible para los clientes nuevos. Si aún no tienes una licencia del plan Premium, no llames a setAuthentication(clientId, signingKey). Puedes usar los métodos Maps con las asignaciones de cuota predeterminadas.

Maps.setAuthentication('gme-123456789', 'VhSEZvOXVSdnlxTnpJcUE');

Parámetros

Nombre	Tipo	Descripción
clientId	String	Un identificador de cliente.
signingKey	String	Una clave de firma privada.

Arroja

Error : Si setAuthenticationByApiKey(apiKey) ya se usa para la autenticación.