A latitude-longitude viewport, represented as two diagonally oppositelowandhighpoints. 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.
Bothlowandhighmust 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:
[[["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-08-27 UTC."],[[["\u003cp\u003eA Viewport is defined by two points, \u003ccode\u003elow\u003c/code\u003e and \u003ccode\u003ehigh\u003c/code\u003e, representing the Southwest and Northeast corners respectively, forming a rectangular area on a map.\u003c/p\u003e\n"],["\u003cp\u003eLatitude ranges from -90 to +90 degrees, while longitude ranges from -180 to +180 degrees, inclusive.\u003c/p\u003e\n"],["\u003cp\u003eSpecific conditions, like inverted longitude or empty latitude ranges, are defined for special viewport scenarios.\u003c/p\u003e\n"],["\u003cp\u003eBoth \u003ccode\u003elow\u003c/code\u003e and \u003ccode\u003ehigh\u003c/code\u003e points are mandatory, and the resulting viewport must represent a valid, non-empty area to avoid errors.\u003c/p\u003e\n"]]],["A viewport, defined by `low` and `high` latitude-longitude points, represents a closed geographical region. Both `low` and `high` points are mandatory. The longitude range inverts if `low.longitude` exceeds `high.longitude`. Specific cases include single-point viewports if `low` equals `high`, full longitude coverage if the longitude ranges from -180 to 180, and empty ranges if the `low` point exceedes `high` respectively in longitude or latitude. An empty viewport is considered an error.\n"],null,["# Package google.geo.type\n\nIndex\n-----\n\n- [Viewport](/maps/documentation/routes/reference/rpc/google.geo.type#google.geo.type.Viewport) (message)\n\nViewport\n--------\n\nA 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:\n\n- If `low` = `high`, the viewport consists of that single point.\n\n- If `low.longitude` \\\u003e `high.longitude`, the longitude range is inverted (the viewport crosses the 180 degree longitude line).\n\n- If `low.longitude` = -180 degrees and `high.longitude` = 180 degrees, the viewport includes all longitudes.\n\n- If `low.longitude` = 180 degrees and `high.longitude` = -180 degrees, the longitude range is empty.\n\n- If `low.latitude` \\\u003e `high.latitude`, the latitude range is empty.\n\nBoth `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.\n\nFor example, this viewport fully encloses New York City:\n\n{ \"low\": { \"latitude\": 40.477398, \"longitude\": -74.259087 }, \"high\": { \"latitude\": 40.91618, \"longitude\": -73.70018 } }\n\n| Fields ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------|\n| `low` | [LatLng](/maps/documentation/routes/reference/rpc/google.type#google.type.LatLng) Required. The low point of the viewport. |\n| `high` | [LatLng](/maps/documentation/routes/reference/rpc/google.type#google.type.LatLng) Required. The high point of the viewport. |"]]