Package google.geo.type

  • A Viewport is defined by two points,low andhigh, representing the southwest and northeast corners of a rectangular area on a map.

  • It's crucial thatlow latitude is less thanhigh latitude and, generally,low longitude is less thanhigh longitude for the viewport to be valid.

  • The viewport encompasses all points within its boundaries, including the boundary lines themselves.

  • Special cases exist where longitude ranges can be inverted or represent the entire globe, but latitude ranges must be logically ordered.

  • Bothlow andhigh points are mandatory, and the resulting viewport cannot be empty, otherwise, an error will occur.

Index

Viewport

A latitude-longitude viewport, represented as two diagonally oppositelow andhigh points. A viewport is considered a closed region, i.e. it includes its boundary. The latitude bounds must range between -90 to 90 degrees inclusive, and the longitude bounds must range between -180 to 180 degrees inclusive. Various cases include:

  • Iflow =high, the viewport consists of that single point.

  • Iflow.longitude >high.longitude, the longitude range is inverted (the viewport crosses the 180 degree longitude line).

  • Iflow.longitude = -180 degrees andhigh.longitude = 180 degrees, the viewport includes all longitudes.

  • Iflow.longitude = 180 degrees andhigh.longitude = -180 degrees, the longitude range is empty.

  • Iflow.latitude >high.latitude, the latitude range is empty.

Bothlow andhigh must be populated, and the represented box cannot be empty (as specified by the definitions above). An empty viewport will result in an error.

For example, this viewport fully encloses New York City:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Fields
low

LatLng

Required. The low point of the viewport.

high

LatLng

Required. The high point of the viewport.

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-08-27 UTC.