Class Maps

Decodes an encoded polyline string back into an array of points.

// 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]);
}

Parameters

Return

Number[] — An array of latitude longitude pairs (lat0, long0, lat1, long1, ...).

See also

• Encoded Polyline Format

Encodes an array of points into a string.

// 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);

Parameters

Return

String — An encoded string representing those points.

See also

• Encoded Polyline Format

Creates a new DirectionFinder object.

Return

DirectionFinder — A new direction finder object.

Creates an ElevationSampler object.

Return

ElevationSampler — A new elevation sampler object.

Creates a new Geocoder object.

Return

Geocoder — A new geocoder object.

Creates a new StaticMap object.

Return

StaticMap — A new static map object.

Resets the authentication credentials to use the default quota allowances. This method works when you are using API key to authenticate requests. This method can be used to revert back to the default quota allowances if you want to use the Maps methods without providing authentication credentials.

Maps.resetAuthenticationApiKey();

Throws

Error — if setAuthentication(clientId, signingKey) is being used for authentication.

Enables the use of an API key to authenticate requests to leverage additional quotas.

This method is used to set an API key which is used to authenticate requests. When this method is called, quota consumption and billing are charged to the Google Cloud project associated with the provided API key according to the pricing sheet. You are able to use the Maps methods with the default quota allowances without providing authentication credentials. If you are using StaticMap, please use setAuthenticationByApiKey(apiKey, signingKey) method instead.

Maps.setAuthenticationByApiKey('BBdgJpSbLtAtmkBFjgLt310qT6iekggfDdVqLC0');

Parameters

Throws

Error — if the apiKey is null, or if setAuthentication(clientId, signingKey) is already being used for authentication

Enables the use of an API key and Signing Key to authenticate requests to leverage additional quotas in StaticMap. While the signingKey is required for requests to the Static Map API, this method can also be used to authenticate other Maps services. In those cases, the signingKey parameter is ignored.

This method is used to set an API key and Signing Key which is used to authenticate requests. Signing Key is required for StaticMap, it accepts a small number of requests without signature for testing purposes, but they start failing once it hits the threshold in your production. More details can be found here.

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

Parameters

Throws

Error — if the apiKey is null, or if setAuthentication(clientId, signingKey) is already being used for authentication

See also

• setAuthenticationByApiKey(apiKey)