Viewport

Широта-долгота — это область просмотра, представленная двумя расположенными по диагонали low и high точками. Область просмотра считается замкнутой областью, то есть включает в себя свои границы. Границы широты должны находиться в диапазоне от -90 до 90 градусов включительно, а границы долготы — в диапазоне от -180 до 180 градусов включительно. Возможны различные варианты:

  • Если low = high , то область просмотра состоит из этой единственной точки.

  • Если low.longitude > high.longitude , диапазон долготы инвертируется (область просмотра пересекает линию долготы в 180 градусов).

  • Если low.longitude = -180 градусов и high.longitude = 180 градусов, то область просмотра будет включать все долготы.

  • Если low.longitude = 180 градусов и high.longitude = -180 градусов, то диапазон долготы пуст.

  • Если low.latitude > high.latitude , диапазон широт пуст.

Необходимо заполнить поля low и high , при этом отображаемый прямоугольник не может быть пустым (как указано в приведенных выше определениях). Пустой экран приведет к ошибке.

Например, этот иллюминатор полностью охватывает Нью-Йорк:

{ "низкая": { "широта": 40.477398, "долгота": -74.259087 }, "высокая": { "широта": 40.91618, "долгота": -73.70018 } }

JSON-представление 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Поля
low

object ( LatLng )

Обязательно. Нижняя точка области просмотра.

high

object ( LatLng )

Обязательно. Самая высокая точка в области просмотра.

LatLng

Объект, представляющий пару координат широты и долготы. Он выражается в виде пары чисел с плавающей запятой (double), обозначающих градусы широты и долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.

JSON-представление 
{
  "latitude": number,
  "longitude": number
}
Поля
latitude

number

Широта в градусах. Она должна находиться в диапазоне [-90,0, +90,0].

longitude

number

Долгота в градусах. Она должна находиться в диапазоне [-180,0, +180,0].