Урок - Объект LatLng (Географические координаты)

Главная » Курсы » Курс Google Maps 3, примеры использования. » Урок - Объект LatLng (Географические координаты)

Обучающий онлайн курс
Google Maps 3, примеры использования.

Лицензия: Копирование запрещено.

LatLng-объект хранит в себе информацию о географических координатах точки: широту и долготу.

Широта имеет диапазон от -90 до 90 градусов включительно. Значения выше или ниже этого диапазона будет прикреплен к ближайшему значению в пределах этого диапазона. Например, при указании широты 100 градусов - будет установлено значение 90 градусов.

Долгота имеет диапазон от -180 до 180 градусов включительно. Значения выше или ниже этого диапазона будут включены так, что бы они попадали в диапазон [-180, 180) (прим. больше или равно -180 и меньше 180 градусов). Например, указывая 480, 840 или 1200 грудусов получим значение долготы равное 120 градусам.

Обратите внимание, хотя X-координату ассоциируют с долготой, а Y-координату с широтой, при указании географических координат сначала указывается широту(Y-координата), а затем долготу (X-координату).

Обратите внимание, что вы не можете изменить координаты LatLng-объекта. Если необходимо вычислить еще одну координату - необходимо создать новую координату.

Создание объекта LatLng.

Создается LatLng-объект командой:

new google.maps.LatLng(lat:number, lng:number, noWrap?:boolean);

где lat - широта, число в диапозоне [-90,90] градусов, lng - долгота, число в диапозоне [-180,180], noWrap - установите в true, что бы задавать значения вне указанных диапозонов.

Пример создания LatLng-объекта:

var LatLng1 = new google.maps.LatLng(-45, 120);
var LatLng2 = new google.maps.LatLng(120, -1300.07, true);

Свойства LatLng-объекта.

У LatLng-объекта нет свойств.

Что бы получить географическую координату с новыми координатами - необходимо создать другой LatLng-объект.

Методы LatLng-объекта.

У LatLng-объекта существует методы:

  • equals(other:LatLng) - сравнивает указанный LatLng-объект с текущим LatLng-объектом.
  • lat() - возвращает широту.
  • lng() - возвращает долготу.
  • toString() - вернет строковое представление LatLng-объекта.
  • toUrlValue(precision?:number) - возвращает строку вида "lat,lng" для текущего LatLng-объекта. Округляя до указанного значения в параметре precision (по умолчанию до 6 знаков после запятой).