Last updated Thursday, May 10, 2018
This reference documents version 3.32 (the release version) of the Maps JavaScript API. This release version of the API is a feature-stable version of the API whose interfaces are guaranteed to remain as documented within these pages until this version is retired.
To consult the latest (experimental) version of the Maps Javascript API, see the Experimental Development Reference.
This reference is kept up to date with the latest changes to the API. Please consult the Javascript Maps API release notes for information on what's new in each release.
Maps
Maps
- Map class
Methods: fitBounds, getBounds, getCenter, getClickableIcons, getDiv, getHeading, getMapTypeId, getProjection, getStreetView, getTilt, getZoom, panBy, panTo, panToBounds, setCenter, setClickableIcons, setHeading, setMapTypeId, setOptions, setStreetView, setTilt, setZoom
Properties: controls, data, mapTypes, overlayMapTypes
Events: bounds_changed, center_changed, click, dblclick, drag, dragend, dragstart, heading_changed, idle, maptypeid_changed, mousemove, mouseout, mouseover, projection_changed, rightclick, tilesloaded, tilt_changed, zoom_changed
- MapOptions interface
Properties: backgroundColor, center, clickableIcons, disableDefaultUI, disableDoubleClickZoom, draggable, draggableCursor, draggingCursor, fullscreenControl, fullscreenControlOptions, gestureHandling, heading, keyboardShortcuts, mapTypeControl, mapTypeControlOptions, mapTypeId, maxZoom, minZoom, noClear, panControl, panControlOptions, rotateControl, rotateControlOptions, scaleControl, scaleControlOptions, scrollwheel, streetView, streetViewControl, streetViewControlOptions, styles, tilt, zoom, zoomControl, zoomControlOptions
- MapTypeStyle interface
Properties: elementType, featureType, stylers
- MouseEvent interface
Methods: stop
Properties: latLng
- IconMouseEvent interface
Properties: placeId
- MapTypeId constants
- MapTypeRegistry class
Methods: set
- TrafficLayer class
Methods: getMap, setMap, setOptions
- TrafficLayerOptions interface
Properties: autoRefresh, map
- TransitLayer class
- BicyclingLayer class
Coordinates
- LatLng class
- LatLngLiteral interface
- LatLngBounds class
Methods: contains, equals, extend, getCenter, getNorthEast, getSouthWest, intersects, isEmpty, toJSON, toSpan, toString, toUrlValue, union
- LatLngBoundsLiteral interface
- Point class
- Size class
- Padding interface
Event system
- event namespace
Static Methods: addDomListener, addDomListenerOnce, addListener, addListenerOnce, clearInstanceListeners, clearListeners, removeListener, trigger
- MapsEventListener interface
Methods: remove
- MVCObject class
Methods: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
- MVCArray class
Methods: clear, forEach, getArray, getAt, getLength, insertAt, pop, push, removeAt, setAt
Controls
- FullscreenControlOptions interface
Properties: position
- MapTypeControlOptions interface
Properties: mapTypeIds, position, style
- MapTypeControlStyle constants
Constants: DEFAULT, DROPDOWN_MENU, HORIZONTAL_BAR
- MotionTrackingControlOptions interface
Properties: position
- PanControlOptions interface
Properties: position
- RotateControlOptions interface
Properties: position
- ScaleControlOptions interface
Properties: style
- ScaleControlStyle constants
Constants: DEFAULT
- StreetViewControlOptions interface
Properties: position
- ZoomControlOptions interface
Properties: position
- ControlPosition constants
Constants: BOTTOM_CENTER, BOTTOM_LEFT, BOTTOM_RIGHT, LEFT_BOTTOM, LEFT_CENTER, LEFT_TOP, RIGHT_BOTTOM, RIGHT_CENTER, RIGHT_TOP, TOP_CENTER, TOP_LEFT, TOP_RIGHT
Geometry Library
- encoding namespace
Static Methods: decodePath, encodePath
- spherical namespace
Static Methods: computeArea, computeDistanceBetween, computeHeading, computeLength, computeOffset, computeOffsetOrigin, computeSignedArea, interpolate
- poly namespace
Static Methods: containsLocation, isLocationOnEdge
Drawing on the map
Marker
- Marker class
Methods: getAnimation, getClickable, getCursor, getDraggable, getIcon, getLabel, getMap, getOpacity, getPosition, getShape, getTitle, getVisible, getZIndex, setAnimation, setClickable, setCursor, setDraggable, setIcon, setLabel, setMap, setOpacity, setOptions, setPosition, setShape, setTitle, setVisible, setZIndex
Constants: MAX_ZINDEX
Events: animation_changed, click, clickable_changed, cursor_changed, dblclick, drag, dragend, draggable_changed, dragstart, flat_changed, icon_changed, mousedown, mouseout, mouseover, mouseup, position_changed, rightclick, shape_changed, title_changed, visible_changed, zindex_changed
- MarkerOptions interface
Properties: anchorPoint, animation, clickable, crossOnDrag, cursor, draggable, icon, label, map, opacity, optimized, position, shape, title, visible, zIndex
- Icon interface
Properties: anchor, labelOrigin, origin, scaledSize, size, url
- MarkerLabel interface
Properties: color, fontFamily, fontSize, fontWeight, text
- MarkerShape interface
- Symbol interface
Properties: anchor, fillColor, fillOpacity, labelOrigin, path, rotation, scale, strokeColor, strokeOpacity, strokeWeight
- SymbolPath constants
Constants: BACKWARD_CLOSED_ARROW, BACKWARD_OPEN_ARROW, CIRCLE, FORWARD_CLOSED_ARROW, FORWARD_OPEN_ARROW
- Animation constants
Info Window
- InfoWindow class
Methods: close, getContent, getPosition, getZIndex, open, setContent, setOptions, setPosition, setZIndex
Events: closeclick, content_changed, domready, position_changed, zindex_changed
- InfoWindowOptions interface
Properties: content, disableAutoPan, maxWidth, pixelOffset, position, zIndex
Polygons
- Polyline class
Methods: getDraggable, getEditable, getMap, getPath, getVisible, setDraggable, setEditable, setMap, setOptions, setPath, setVisible
Events: click, dblclick, drag, dragend, dragstart, mousedown, mousemove, mouseout, mouseover, mouseup, rightclick
- PolylineOptions interface
Properties: clickable, draggable, editable, geodesic, icons, map, path, strokeColor, strokeOpacity, strokeWeight, visible, zIndex
- IconSequence interface
Properties: fixedRotation, icon, offset, repeat
- Polygon class
Methods: getDraggable, getEditable, getMap, getPath, getPaths, getVisible, setDraggable, setEditable, setMap, setOptions, setPath, setPaths, setVisible
Events: click, dblclick, drag, dragend, dragstart, mousedown, mousemove, mouseout, mouseover, mouseup, rightclick
- PolygonOptions interface
Properties: clickable, draggable, editable, fillColor, fillOpacity, geodesic, map, paths, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex
- PolyMouseEvent interface
- Rectangle class
Methods: getBounds, getDraggable, getEditable, getMap, getVisible, setBounds, setDraggable, setEditable, setMap, setOptions, setVisible
Events: bounds_changed, click, dblclick, drag, dragend, dragstart, mousedown, mousemove, mouseout, mouseover, mouseup, rightclick
- RectangleOptions interface
Properties: bounds, clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex
- Circle class
Methods: getBounds, getCenter, getDraggable, getEditable, getMap, getRadius, getVisible, setCenter, setDraggable, setEditable, setMap, setOptions, setRadius, setVisible
Events: center_changed, click, dblclick, drag, dragend, dragstart, mousedown, mousemove, mouseout, mouseover, mouseup, radius_changed, rightclick
- CircleOptions interface
Properties: center, clickable, draggable, editable, fillColor, fillOpacity, map, radius, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex
- StrokePosition constants
Data
- Data class
Methods: add, addGeoJson, contains, forEach, getControlPosition, getControls, getDrawingMode, getFeatureById, getMap, getStyle, loadGeoJson, overrideStyle, remove, revertStyle, setControlPosition, setControls, setDrawingMode, setMap, setStyle, toGeoJson
Events: addfeature, click, dblclick, mousedown, mouseout, mouseover, mouseup, removefeature, removeproperty, rightclick, setgeometry, setproperty
- Data.DataOptions interface
Properties: controlPosition, controls, drawingMode, featureFactory, map, style
- Data.GeoJsonOptions interface
Properties: idPropertyName
- Data.StyleOptions interface
Properties: clickable, cursor, draggable, editable, fillColor, fillOpacity, icon, shape, strokeColor, strokeOpacity, strokeWeight, title, visible, zIndex
- Data.StylingFunction typedef
- Data.Feature class
Methods: forEachProperty, getGeometry, getId, getProperty, removeProperty, setGeometry, setProperty, toGeoJson
Events: removeproperty, setgeometry, setproperty
- Data.FeatureOptions interface
Properties: geometry, id, properties
- Data.Geometry interface
Methods: forEachLatLng, getType
- Data.Point class
Methods: forEachLatLng, get, getType
- Data.MultiPoint class
Methods: forEachLatLng, getArray, getAt, getLength, getType
- Data.LineString class
Methods: forEachLatLng, getArray, getAt, getLength, getType
- Data.MultiLineString class
Methods: forEachLatLng, getArray, getAt, getLength, getType
- Data.LinearRing class
Methods: forEachLatLng, getArray, getAt, getLength, getType
- Data.Polygon class
Methods: forEachLatLng, getArray, getAt, getLength, getType
- Data.MultiPolygon class
Methods: forEachLatLng, getArray, getAt, getLength, getType
- Data.GeometryCollection class
Methods: forEachLatLng, getArray, getAt, getLength, getType
- Data.MouseEvent interface
Properties: feature
- Data.AddFeatureEvent interface
Properties: feature
- Data.RemoveFeatureEvent interface
Properties: feature
- Data.SetGeometryEvent interface
Properties: feature, newGeometry, oldGeometry
- Data.SetPropertyEvent interface
- Data.RemovePropertyEvent interface
DOM elements
- OverlayView class
Methods: draw, getMap, getPanes, getProjection, onAdd, onRemove, setMap
- MapPanes interface
Properties: floatPane, mapPane, markerLayer, overlayLayer, overlayMouseTarget
- MapCanvasProjection interface
Methods: fromContainerPixelToLatLng, fromDivPixelToLatLng, fromLatLngToContainerPixel, fromLatLngToDivPixel, getWorldWidth
KML
- KmlLayer class
Methods: getDefaultViewport, getMap, getMetadata, getStatus, getUrl, getZIndex, setMap, setOptions, setUrl, setZIndex
Events: click, defaultviewport_changed, status_changed
- KmlLayerOptions interface
Properties: clickable, map, preserveViewport, screenOverlays, suppressInfoWindows, url, zIndex
- KmlLayerMetadata interface
Properties: author, description, hasScreenOverlays, name, snippet
- KmlLayerStatus constants
Constants: DOCUMENT_NOT_FOUND, DOCUMENT_TOO_LARGE, FETCH_ERROR, INVALID_DOCUMENT, INVALID_REQUEST, LIMITS_EXCEEDED, OK, TIMED_OUT, UNKNOWN
- KmlMouseEvent interface
Properties: featureData, latLng, pixelOffset
- KmlFeatureData interface
Properties: author, description, id, infoWindowHtml, name, snippet
- KmlAuthor interface
Fusion Tables
- FusionTablesLayer class
Methods: getMap, setMap, setOptions
Events: click
- FusionTablesLayerOptions interface
Properties: clickable, heatmap, map, query, styles, suppressInfoWindows
- FusionTablesQuery interface
- FusionTablesStyle interface
Properties: markerOptions, polygonOptions, polylineOptions, where
- FusionTablesHeatmap interface
Properties: enabled
- FusionTablesMarkerOptions interface
Properties: iconName
- FusionTablesPolygonOptions interface
Properties: fillColor, fillOpacity, strokeColor, strokeOpacity, strokeWeight
- FusionTablesPolylineOptions interface
Properties: strokeColor, strokeOpacity, strokeWeight
- FusionTablesMouseEvent interface
Properties: infoWindowHtml, latLng, pixelOffset, row
- FusionTablesCell interface
Properties: columnName, value
Image overlays
- MapType interface
Methods: getTile, releaseTile
Properties: alt, maxZoom, minZoom, name, projection, radius, tileSize
- Projection interface
Methods: fromLatLngToPoint, fromPointToLatLng
- ImageMapType class
Methods: getOpacity, getTile, releaseTile, setOpacity
Properties: alt, maxZoom, minZoom, name, projection, radius, tileSize
Events: tilesloaded
- ImageMapTypeOptions interface
Properties: alt, getTileUrl, maxZoom, minZoom, name, opacity, tileSize
- GroundOverlay class
Methods: getBounds, getMap, getOpacity, getUrl, setMap, setOpacity
- GroundOverlayOptions interface
- StyledMapType class
Methods: getTile, releaseTile
Properties: alt, maxZoom, minZoom, name, projection, radius, tileSize
- StyledMapTypeOptions interface
Drawing Library
- DrawingManager class
Methods: getDrawingMode, getMap, setDrawingMode, setMap, setOptions
Events: circlecomplete, markercomplete, overlaycomplete, polygoncomplete, polylinecomplete, rectanglecomplete
- DrawingManagerOptions interface
Properties: circleOptions, drawingControl, drawingControlOptions, drawingMode, map, markerOptions, polygonOptions, polylineOptions, rectangleOptions
- DrawingControlOptions interface
Properties: drawingModes, position
- OverlayCompleteEvent interface
- OverlayType constants
Heatmaps
- HeatmapLayer class
Methods: getData, getMap, setData, setMap, setOptions
- HeatmapLayerOptions interface
Properties: data, dissipating, gradient, map, maxIntensity, opacity, radius
- WeightedLocation interface
Max Zoom
Street View
Rendering
- StreetViewPanorama class
Methods: getLinks, getLocation, getMotionTracking, getPano, getPhotographerPov, getPosition, getPov, getStatus, getVisible, getZoom, registerPanoProvider, setLinks, setMotionTracking, setOptions, setPano, setPosition, setPov, setVisible, setZoom
Properties: controls
Events: closeclick, pano_changed, position_changed, pov_changed, resize, status_changed, visible_changed, zoom_changed
- StreetViewPanoramaOptions interface
Properties: addressControl, addressControlOptions, clickToGo, disableDefaultUI, disableDoubleClickZoom, enableCloseButton, fullscreenControl, fullscreenControlOptions, imageDateControl, linksControl, motionTracking, motionTrackingControl, motionTrackingControlOptions, panControl, panControlOptions, pano, position, pov, scrollwheel, showRoadLabels, visible, zoom, zoomControl, zoomControlOptions
- StreetViewAddressControlOptions interface
Properties: position
- PanoProviderOptions interface
Properties: cors
- StreetViewTileData interface
Methods: getTileUrl
Properties: centerHeading, tileSize, worldSize
- StreetViewPov interface
- StreetViewCoverageLayer class
Service
- StreetViewService class
Methods: getPanorama
- StreetViewStatus constants
Constants: OK, UNKNOWN_ERROR, ZERO_RESULTS
- StreetViewLocationRequest interface
Properties: location, preference, radius, source
- StreetViewPanoRequest interface
Properties: pano
- StreetViewLocation interface
Properties: description, latLng, pano, shortDescription
- StreetViewPreference constants
- StreetViewSource constants
- StreetViewPanoramaData interface
- StreetViewLink interface
Properties: description, heading, pano
Places
Places Widgets
- Autocomplete class
Methods: getBounds, getPlace, setBounds, setComponentRestrictions, setOptions, setTypes
Events: place_changed
- AutocompleteOptions interface
Properties: bounds, componentRestrictions, placeIdOnly, strictBounds, types
- AutocompletePrediction interface
Properties: description, matched_substrings, place_id, structured_formatting, terms, types
- PredictionTerm interface
- PredictionSubstring interface
- AutocompleteService class
Methods: getPlacePredictions, getQueryPredictions
- AutocompletionRequest interface
Properties: bounds, componentRestrictions, input, location, offset, radius, types
- ComponentRestrictions interface
Properties: country
- QueryAutocompletePrediction interface
Properties: description, matched_substrings, place_id, terms
- QueryAutocompletionRequest interface
- RadarSearchRequest interface
- RankBy constants
Constants: DISTANCE, PROMINENCE
- SearchBox class
Methods: getBounds, getPlaces, setBounds
Events: places_changed
- SearchBoxOptions interface
Properties: bounds
- StructuredFormatting interface
Properties: main_text, main_text_matched_substrings, secondary_text
- TextSearchRequest interface
Places Service
- PlaceAspectRating interface
- PlaceDetailsRequest interface
Properties: placeId
- PlaceGeometry interface
- PlacePhoto interface
Methods: getUrl
Properties: height, html_attributions, width
- PhotoOptions interface
- PlaceResult interface
Properties: address_components, aspects, formatted_address, formatted_phone_number, geometry, html_attributions, icon, international_phone_number, name, permanently_closed, photos, place_id, price_level, rating, reviews, types, url, utc_offset, vicinity, website
- PlaceReview interface
Properties: aspects, author_name, author_url, language, text
- PlaceSearchPagination interface
Methods: nextPage
Properties: hasNextPage
- PlaceSearchRequest interface
Properties: bounds, keyword, location, maxPriceLevel, minPriceLevel, name, openNow, radius, rankBy, type
- PlacesService class
Methods: getDetails, nearbySearch, radarSearch, textSearch
- PlacesServiceStatus constants
Constants: INVALID_REQUEST, NOT_FOUND, OK, OVER_QUERY_LIMIT, REQUEST_DENIED, UNKNOWN_ERROR, ZERO_RESULTS
Geocoder
- Geocoder class
Methods: geocode
- GeocoderRequest interface
Properties: address, bounds, componentRestrictions, location, placeId, region
- GeocoderComponentRestrictions interface
Properties: administrativeArea, country, locality, postalCode, route
- GeocoderStatus constants
Constants: ERROR, INVALID_REQUEST, OK, OVER_QUERY_LIMIT, REQUEST_DENIED, UNKNOWN_ERROR, ZERO_RESULTS
- GeocoderResult interface
Properties: address_components, formatted_address, geometry, partial_match, place_id, postcode_localities, types
- GeocoderAddressComponent interface
Properties: long_name, short_name, types
- GeocoderGeometry interface
Properties: bounds, location, location_type, viewport
- GeocoderLocationType constants
Constants: APPROXIMATE, GEOMETRIC_CENTER, RANGE_INTERPOLATED, ROOFTOP
Routes
Directions
- DirectionsService class
Methods: route
- DirectionsRequest interface
Properties: avoidFerries, avoidHighways, avoidTolls, destination, drivingOptions, optimizeWaypoints, origin, provideRouteAlternatives, region, transitOptions, travelMode, unitSystem, waypoints
- DirectionsStatus constants
Constants: INVALID_REQUEST, MAX_WAYPOINTS_EXCEEDED, NOT_FOUND, OK, OVER_QUERY_LIMIT, REQUEST_DENIED, UNKNOWN_ERROR, ZERO_RESULTS
- DirectionsResult interface
Properties: geocoded_waypoints, routes
- DirectionsRenderer class
Methods: getDirections, getMap, getPanel, getRouteIndex, setDirections, setMap, setOptions, setPanel, setRouteIndex
Events: directions_changed
- DirectionsRendererOptions interface
Properties: directions, draggable, hideRouteList, infoWindow, map, markerOptions, panel, polylineOptions, preserveViewport, routeIndex, suppressBicyclingLayer, suppressInfoWindows, suppressMarkers, suppressPolylines
- DirectionsWaypoint interface
- DirectionsGeocodedWaypoint interface
Properties: partial_match, place_id, types
- DirectionsRoute interface
Properties: bounds, copyrights, fare, legs, overview_path, overview_polyline, warnings, waypoint_order
- DirectionsLeg interface
Properties: arrival_time, departure_time, distance, duration, duration_in_traffic, end_address, end_location, start_address, start_location, steps, via_waypoints
- DirectionsStep interface
Properties: distance, duration, end_location, instructions, path, start_location, steps, transit, travel_mode
- Place interface
- TravelMode constants
- DrivingOptions interface
Properties: departureTime, trafficModel
- TrafficModel constants
Constants: BEST_GUESS, OPTIMISTIC, PESSIMISTIC
- TransitOptions interface
Properties: arrivalTime, departureTime, modes, routingPreference
- TransitMode constants
- TransitRoutePreference constants
Constants: FEWER_TRANSFERS, LESS_WALKING
- TransitFare interface
- TransitDetails interface
Properties: arrival_stop, arrival_time, departure_stop, departure_time, headsign, headway, line, num_stops
- TransitStop interface
- TransitLine interface
Properties: agencies, color, icon, name, short_name, text_color, url, vehicle
- TransitAgency interface
- TransitVehicle interface
Properties: icon, local_icon, name, type
- VehicleType constants
Constants: BUS, CABLE_CAR, COMMUTER_TRAIN, FERRY, FUNICULAR, GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN, INTERCITY_BUS, METRO_RAIL, MONORAIL, OTHER, RAIL, SHARE_TAXI, SUBWAY, TRAM, TROLLEYBUS
- UnitSystem constants
- Distance interface
- Duration interface
- Time interface
Distance Matrix
- DistanceMatrixService class
Methods: getDistanceMatrix
- DistanceMatrixRequest interface
Properties: avoidFerries, avoidHighways, avoidTolls, destinations, drivingOptions, origins, region, transitOptions, travelMode, unitSystem
- DistanceMatrixResponse interface
Properties: destinationAddresses, originAddresses, rows
- DistanceMatrixResponseRow interface
Properties: elements
- DistanceMatrixResponseElement interface
Properties: distance, duration, duration_in_traffic, fare, status
- DistanceMatrixStatus constants
Constants: INVALID_REQUEST, MAX_DIMENSIONS_EXCEEDED, MAX_ELEMENTS_EXCEEDED, OK, OVER_QUERY_LIMIT, REQUEST_DENIED, UNKNOWN_ERROR
- DistanceMatrixElementStatus constants
Constants: NOT_FOUND, OK, ZERO_RESULTS