GeolocationCoordinates: свойство longitude
Базовая Широко доступная
Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Защищённый контекст: Эта функция доступна только в защищённых контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.
Только для чтения longitude свойство интерфейса GeolocationCoordinates — число, представляющее долготу географической позиции в десятичных градусах. Вместе со временем, указанным в миллисекундах времени Unix, указывающим время измерения, объект GeolocationCoordinates является частью интерфейса GeolocationPosition, который представляет собой тип объекта, возвращаемого функциями API геолокации, получающими и возвращающими географическую позицию.
Значение
Значение в longitude — это географическая долгота местоположения на Земле, описываемая объектом Coordinates в десятичных градусах. Значение определено спецификацией системы мировой геодезии 1984 года (WGS 84).
Примечание: Нулевой меридиан (также известный как главный меридиан или меридиан отсчёта) не совпадает точно с меридианом Гринвича, который большинство людей обычно имеют в виду. Вместо этого это меридиан отсчёта IERS, который находится на 5,3 дуговых секунды (102 метра / 335 футов) восточнее меридиана Гринвича. Это тот же стандарт, который используется системой глобального позиционирования (GPS).
Примеры
В этом простом примере мы получаем местоположение пользователя и отображаем полученные координаты после их возвращения.
JavaScript
Приведённый ниже код JavaScript создаёт обработчик событий, чтобы при нажатии пользователем на кнопку извлекать и отображать информацию о местоположении.
let button = document.getElementById("get-location");
let latText = document.getElementById("latitude");
let longText = document.getElementById("longitude");
button.addEventListener("click", () => {
navigator.geolocation.getCurrentPosition((position) => {
let lat = position.coords.latitude;
let long = position.coords.longitude;
latText.innerText = lat.toFixed(2);
longText.innerText = long.toFixed(2);
});
});
После создания переменных для более удобной ссылки на элемент кнопки и двух элементов, в которые будут отображаться широта и долгота, обработчик событий устанавливается путём вызова addEventListener() для элемента <button>. При нажатии пользователем кнопки мы получим и отобразим информацию о местоположении.
При получении события click мы вызываем getCurrentPosition() для запроса текущего местоположения устройства. Это асинхронный запрос, поэтому мы предоставляем обратный вызов, который принимает в качестве входных данных объект GeolocationPosition, описывающий определённое местоположение.
Из объекта GeolocationPosition мы получаем широту и долготу пользователя, используя position.coords.latitude и position.coords.longitude, чтобы обновить отображаемые координаты. Два элемента <span> обновляются для отображения соответствующих значений после преобразования в значение с двумя десятичными знаками.
HTML
HTML для представления результатов выглядит следующим образом:
<p> Your location is <span id="latitude">0.00</span>° latitude by <span id="longitude">0.00</span>° longitude. </p> <button id="get-location">Get My Location</button>
Результат
Протестируйте этот пример здесь:
Спецификации
Совместимость браузеров
| Рабочий стол | Мобильный | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
longitude |
5 | 12 | 3.5 | 1610.6–15 | 5 | 18 | 4 | 1611–14 | ≤3 | 1.0 | ≤37 |
См. также
- Использование API геолокации
- Интерфейс
GeolocationCoordinates, к которому он принадлежит. - Интерфейс
GeolocationPosition, который является интерфейсом верхнего уровня, используемым для возвращения данных геолокации из функций API геолокацииGeolocation.getCurrentPosition()иwatchPosition().
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GeolocationCoordinates/longitude