Places UI Kit: A ready-to-use library that provides room for customization and low-code development. Try it out, and share yourinput on your UI Kit experience.

Max Zoom

MaxZoomServiceclass

google.maps.MaxZoomServiceclass

A service for obtaining the highest zoom level at which satellite imagery is available for a given location.

Access by callingconst {MaxZoomService} = await google.maps.importLibrary("maps").
SeeLibraries in the Maps JavaScript API.

Constructor

MaxZoomService
MaxZoomService()
Parameters:  None
Creates a new instance of aMaxZoomService that can be used to send queries about the maximum zoom level available for satellite imagery.

Methods

getMaxZoomAtLatLng
getMaxZoomAtLatLng(latlng[, callback])
Parameters: 
Return Value: Promise<MaxZoomResult>
Returns the maximum zoom level for which detailed imagery is available at a particularLatLng for thesatellite map type. As this request is asynchronous, you must pass acallback function which will be executed upon completion of the request, being passed aMaxZoomResult.

MaxZoomResultinterface

google.maps.MaxZoomResultinterface

A MaxZoom result in JSON format retrieved from the MaxZoomService.

Properties

zoom
Type: number
The maximum zoom level found at the givenLatLng.
statusoptional
Type: MaxZoomStatusoptional
Status of the request. This property is only defined when using callbacks withMaxZoomService.getMaxZoomAtLatLng (it is not defined when using Promises).

MaxZoomStatusconstants

google.maps.MaxZoomStatusconstants

The status returned by theMaxZoomService on the completion of a call togetMaxZoomAtLatLng(). Specify these by value, or by using the constant's name. For example,'OK' orgoogle.maps.MaxZoomStatus.OK.

Access by callingconst {MaxZoomStatus} = await google.maps.importLibrary("maps").
SeeLibraries in the Maps JavaScript API.

Constants

ERRORAn unknown error occurred.
OKThe response contains a validMaxZoomResult.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-21 UTC.