Spec-Zone.ru › Web APIs

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>

Результат

Протестируйте этот пример здесь:

Спецификации

Спецификация
Геолокация
# latitude-longitude-and-accuracy-attributes

Совместимость браузеров

Рабочий стол Мобильный
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API