Maps Service

This service allows scripts to generate static maps, find directions, convert addresses into geocode coordinates, and sample elevations.

Classes

Name	Brief description
`Avoid`	An enum representing the types of restrictions to avoid when finding directions.
`Color`	An enum representing the named colors available to use in map images.
`DirectionFinder`	Allows for the retrieval of directions between locations.
`DirectionFinderEnums`	A collection of enums used by `DirectionFinder`.
`ElevationSampler`	Allows for the sampling of elevations at particular locations.
`Format`	An enum representing the format of the map image.
`Geocoder`	Allows for the conversion between an address and geographical coordinates.
`Maps`	Allows for direction finding, geocoding, elevation sampling and the creation of static map images.
`MarkerSize`	An enum representing the size of a marker added to a map.
`Mode`	An enum representing the mode of travel to use when finding directions.
`StaticMap`	Allows for the creation and decoration of static map images.
`StaticMapEnums`	A collection of enums used by `StaticMap`.
`Type`	An enum representing the type of map to render.

`Avoid`

Properties

Property	Type	Description
`TOLLS`	`Enum`	Avoid tolls.
`HIGHWAYS`	`Enum`	Avoid highways.

`Color`

Properties

Property	Type	Description
`BLACK`	`Enum`
`BROWN`	`Enum`
`GREEN`	`Enum`
`PURPLE`	`Enum`
`YELLOW`	`Enum`
`BLUE`	`Enum`
`GRAY`	`Enum`
`ORANGE`	`Enum`
`RED`	`Enum`
`WHITE`	`Enum`

`DirectionFinder`

Methods

Method	Return type	Brief description
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Adds a waypoint that the route must pass through, using a point (lat/lng).
`addWaypoint(address)`	`DirectionFinder`	Adds a waypoint that the route must pass through, using an address.
`clearWaypoints()`	`DirectionFinder`	Clears the current set of waypoints.
`getDirections()`	`Object`	Gets the directions using the origin, destination, and other options that were set.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Sets whether or not alternative routes should be returned, instead of just the highest ranked route (defaults to false).
`setArrive(time)`	`DirectionFinder`	Sets the desired time of arrival (when applicable).
`setAvoid(avoid)`	`DirectionFinder`	Sets whether to avoid certain types of restrictions.
`setDepart(time)`	`DirectionFinder`	Sets the desired time of departure (when applicable).
`setDestination(latitude, longitude)`	`DirectionFinder`	Sets the ending location for which to calculate directions to, using a point (lat/lng).
`setDestination(address)`	`DirectionFinder`	Sets the ending location for which to calculate directions to, using an address.
`setLanguage(language)`	`DirectionFinder`	Sets the language to be used for the directions.
`setMode(mode)`	`DirectionFinder`	Sets the mode of travel (defaults to driving).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Sets whether or not to optimize the provided route by rearranging the waypoints in a more efficient order (defaults to false).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Sets the starting location from which to calculate directions, using a point (lat/lng).
`setOrigin(address)`	`DirectionFinder`	Sets the starting location from which to calculate directions, using an address.
`setRegion(region)`	`DirectionFinder`	Sets a region to use when interpreting location names.

`DirectionFinderEnums`

Properties

Property	Type	Description
`Avoid`	`Avoid`
`Mode`	`Mode`

`ElevationSampler`

Methods

Method	Return type	Brief description
`sampleLocation(latitude, longitude)`	`Object`	Returns elevation data for a single point (lat/lng).
`sampleLocations(points)`	`Object`	Returns elevation data for a series of points (lat/lng).
`sampleLocations(encodedPolyline)`	`Object`	Returns elevation data for the points in an encoded polyline.
`samplePath(points, numSamples)`	`Object`	Returns elevation data for a number of samples along a line, defined using a series of points.
`samplePath(encodedPolyline, numSamples)`	`Object`	Returns elevation data for a number of samples along a line, defined using an encoded polyline.

`Format`

Properties

Property	Type	Description
`PNG`	`Enum`	8-bit PNG format.
`PNG8`	`Enum`	8-bit PNG format.
`PNG32`	`Enum`	32-bit PNG format.
`GIF`	`Enum`	GIF format.
`JPG`	`Enum`	JPEG format.
`JPG_BASELINE`	`Enum`	Non-progressive JPEG format.

`Geocoder`

Methods

Method	Return type	Brief description
`geocode(address)`	`Object`	Gets the approximate geographic points for a given address.
`reverseGeocode(latitude, longitude)`	`Object`	Gets the approximate addresses for a given geographic point.
`reverseGeocode(swLatitude, swLongitude, neLatitude, neLongitude)`	`Object`	Gets the approximate addresses for a given area.
`setBounds(swLatitude, swLongitude, neLatitude, neLongitude)`	`Geocoder`	Sets the bounds of an area that should be given extra preference in the results.
`setLanguage(language)`	`Geocoder`	Sets the language to be used in the results.
`setRegion(region)`	`Geocoder`	Sets a region to use when interpreting location names.

`Maps`

Properties

Property	Type	Description
`DirectionFinder`	`DirectionFinderEnums`
`StaticMap`	`StaticMapEnums`

Methods

Method	Return type	Brief description
`decodePolyline(polyline)`	`Number[]`	Decodes an encoded polyline string back into an array of points.
`encodePolyline(points)`	`String`	Encodes an array of points into a string.
`newDirectionFinder()`	`DirectionFinder`	Creates a new DirectionFinder object.
`newElevationSampler()`	`ElevationSampler`	Creates an ElevationSampler object.
`newGeocoder()`	`Geocoder`	Creates a new Geocoder object.
`newStaticMap()`	`StaticMap`	Creates a new StaticMap object.
`setAuthentication(clientId, signingKey)`	`void`	Enables the use of an externally established Google Maps APIs Premium Plan account, to leverage additional quota allowances.

`MarkerSize`

Properties

Property	Type	Description
`TINY`	`Enum`	Tiny sized markets (smallest available).
`MID`	`Enum`	Medium sized markers (largest available).
`SMALL`	`Enum`	Small sized markers.

`Mode`

Properties

Property	Type	Description
`DRIVING`	`Enum`	Driving directions via roads.
`WALKING`	`Enum`	Walking directions via pedestrian paths and sidewalks (where available).
`BICYCLING`	`Enum`	Bicycling directions via bicycle paths and preferred streets (where available).
`TRANSIT`	`Enum`	Transit directions via public transit routes (where available).

`StaticMap`

Methods

Method	Return type	Brief description
`addAddress(address)`	`StaticMap`	Adds a new address to the current path definition.
`addMarker(latitude, longitude)`	`StaticMap`	Adds a marker to the map using a point (lat/lng).
`addMarker(address)`	`StaticMap`	Adds a marker to the map using an address.
`addPath(points)`	`StaticMap`	Adds a path to the map using an array of points.
`addPath(polyline)`	`StaticMap`	Adds a path to the map using an encoded polyline.
`addPoint(latitude, longitude)`	`StaticMap`	Adds a new point (lat/lng) to the current path definition.
`addVisible(latitude, longitude)`	`StaticMap`	Adds a point (lat/lng) location that must be visible in the map.
`addVisible(address)`	`StaticMap`	Adds an address location that must be visible in the map.
`beginPath()`	`StaticMap`	Starts a new path definition.
`clearMarkers()`	`StaticMap`	Clears the current set of markers.
`clearPaths()`	`StaticMap`	Clear the current set of paths.
`clearVisibles()`	`StaticMap`	Clears the current set of visible locations.
`endPath()`	`StaticMap`	Completes a path definition started with beginPath().
`getAs(contentType)`	`Blob`	Return the data inside this object as a blob converted to the specified content type.
`getBlob()`	`Blob`	Gets the image data as a `Blob`.
`getMapImage()`	`Byte[]`	Gets the raw image data as a byte array.
`getMapUrl()`	`String`	Gets the URL of the map image.
`setCenter(latitude, longitude)`	`StaticMap`	Sets the center of the map using a point (lat/lng).
`setCenter(address)`	`StaticMap`	Sets the center of the map using an address.
`setCustomMarkerStyle(imageUrl, useShadow)`	`StaticMap`	Sets the custom marker image to use when creating new markers.
`setFormat(format)`	`StaticMap`	Sets the format of the map image.
`setLanguage(language)`	`StaticMap`	Sets the language to be used for text on the map (where avaialbe).
`setMapType(mapType)`	`StaticMap`	Sets the type of map to be shown.
`setMarkerStyle(size, color, label)`	`StaticMap`	Sets the marker style to use when creating new markers.
`setMobile(useMobileTiles)`	`StaticMap`	Sets whether or not to use specialized tile sets for mobile devices.
`setPathStyle(weight, color, fillColor)`	`StaticMap`	Sets the path style to use when creating new paths.
`setSize(width, height)`	`StaticMap`	Sets the width and height of the map image in pixels.
`setZoom(zoom)`	`StaticMap`	Sets the zoom factor, or magnification level, used for the map.

`StaticMapEnums`

Properties

Property	Type	Description
`Color`	`Color`
`Format`	`Format`
`MarkerSize`	`MarkerSize`
`Type`	`Type`

`Type`

Properties

Property	Type	Description
`ROADMAP`	`Enum`	A standard roadmap, as is normally shown on the Google Maps website.
`SATELLITE`	`Enum`	A satellite map.
`TERRAIN`	`Enum`	A physical relief map, showing terrain and vegetation.
`HYBRID`	`Enum`	A hybrid of the satellite and roadmap maps, showing a transparent layer of major streets and place names on the satellite map.