Package google.geo.type
Stay organized with collections
Save and categorize content based on your preferences.
Viewport
A latitude-longitude viewport, represented as two diagonally opposite low
and high
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:
If low
= high
, the viewport consists of that single point.
If low.longitude
> high.longitude
, the longitude range is inverted (the viewport crosses the 180 degree longitude line).
If low.longitude
= -180 degrees and high.longitude
= 180 degrees, the viewport includes all longitudes.
If low.longitude
= 180 degrees and high.longitude
= -180 degrees, the longitude range is empty.
If low.latitude
> high.latitude
, the latitude range is empty.
Both low
and high
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 the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-26 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-26 UTC."],[[["A Viewport is defined by two points, `low` and `high`, representing the southwest and northeast corners of a rectangular area on a map."],["The latitude and longitude values of these points determine the boundaries of the viewport, allowing for a specific region to be displayed."],["Certain conditions like inverted longitude ranges or empty latitude/longitude ranges are handled specifically within the viewport definition."],["Both `low` and `high` points are mandatory for a valid viewport, and an empty or incorrectly defined viewport will result in an error."]]],["A viewport is defined by two diagonal points, `low` and `high`, representing a latitude-longitude area. Both points are required and must define a non-empty region. Latitude ranges from -90 to 90 degrees, and longitude from -180 to 180 degrees. Inverted longitude ranges cross the 180-degree line. Specific longitude values can indicate all longitudes or an empty range. Inverted latitude order or an undefined `low` or `high` result in an error.\n"]]