Coordinates

Класс LatLng

google.maps . LatLng

LatLng — это точка в географических координатах: широта и долгота.

• Широта находится в диапазоне от -90 до 90 градусов включительно. Значения выше или ниже этого диапазона будут ограничены диапазоном [-90, 90]. Это означает, что если указанное значение меньше -90, оно будет установлено равным -90. А если значение больше 90, оно будет установлено равным 90.
• Диапазон долготы составляет от -180 до 180 градусов включительно. Значения выше или ниже этого диапазона будут преобразованы таким образом, чтобы попасть в него. Например, значение -190 будет преобразовано в 170. Значение 190 будет преобразовано в -170. Это отражает тот факт, что долгота циклически повторяется вокруг земного шара.

Большинство методов, принимающих объекты LatLng , также принимают объект LatLngLiteral , поэтому следующие операторы эквивалентны:

 map.setCenter(new google.maps.LatLng(-34, 151));
 map.setCenter({lat: -34, lng: 151}); 

Конструктор также принимает объекты LatLngLiteral и LatLng . Если конструктору передан экземпляр LatLng , создаётся его копия.

Возможные вызовы конструктора приведены ниже:

 new google.maps.LatLng(-34, 151);
 new google.maps.LatLng(-34, 151, true);
 new google.maps.LatLng({lat: -34, lng: 151});
 new google.maps.LatLng({lat: -34, lng: 151}, true);
 new google.maps.LatLng(new google.maps.LatLng(-34, 151));
 new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
 

Доступ осуществляется путем вызова const {LatLng} = await google.maps.importLibrary("core") .
См. Библиотеки в Maps JavaScript API .

Интерфейс LatLngLiteral

google.maps . LatLngLiteral

Во многих местах для удобства вместо объектов LatLng принимаются литералы объектов. Они преобразуются в объекты LatLng при их обнаружении API Карт.

Примеры:

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); 

Литералы объектов LatLng не поддерживаются в библиотеке Geometry.

Класс LatLngBounds

google.maps . LatLngBounds

Экземпляр LatLngBounds представляет собой прямоугольник в географических координатах, включая тот, который пересекает 180-градусный долготный меридиан.

Доступ осуществляется путем вызова const {LatLngBounds} = await google.maps.importLibrary("core") .
См. Библиотеки в Maps JavaScript API .