System.Device.Location Namespace

Пространство имен System.Device.Location позволяет разработчикам приложений удобным образом обращаться к расположениям на компьютере с использованием единого API. The System.Device.Location namespace allows application developers to easily access the computer's location by using a single API. Сведения о расположении могут получаться от различных поставщиков, таких как GPS, триангуляция Wi-Fi и триангуляция базовых станций сотовых сетей. Location information may come from multiple providers, such as GPS, Wi-Fi triangulation, and cell phone tower triangulation. Классы System.Device.Location предоставляют единый API для инкапсуляции нескольких поставщиков расположений на компьютере и поддерживают эффективную приоритезацию и переключение между ними. The System.Device.Location classes provide a single API to encapsulate the multiple location providers on a computer and support seamless prioritization and transitioning between them. В результате разработчикам приложений, использующим этот интерфейс API, не нужно адаптировать приложения для конкретных аппаратных конфигураций. As a result, application developers who use this API do not need to tailor applications to specific hardware configurations.

Классы

CivicAddress

Представляет административный адрес.Represents a civic address. Административный адрес может включать следующие поля: уличный адрес, почтовый индекс, штат/область и страну или регион.A civic address can include fields such as street address, postal code, state/province, and country or region.

CivicAddressResolver

Предоставляет функциональность для разрешения расположения, выраженного в виде координат, в административный адрес.Provides functionality for resolving a coordinate-based location to a civic address.

GeoCoordinate

Представляет географическое расположение, определяемое координатами широты и долготы.Represents a geographical location that is determined by latitude and longitude coordinates. Может также включать сведения о высоте, погрешности, скорости и курсе.May also include altitude, accuracy, speed, and course information.

GeoCoordinateWatcher

Представляет данные расположения, выраженные в виде координат широты и долготы.Supplies location data that is based on latitude and longitude coordinates.

GeoPosition<T>

Содержит данные расположения типа, заданного параметром типа класса GeoPosition<T>.Contains location data of a type specified by the type parameter of the GeoPosition<T> class.

GeoPositionChangedEventArgs<T>

Предоставляет данные для события PositionChanged.Provides data for the PositionChanged event.

GeoPositionStatusChangedEventArgs

Содержит данные для события GeoPositionStatusChanged.Contains data for a GeoPositionStatusChanged event.

ResolveAddressCompletedEventArgs

Предоставляет данные для события ResolveAddressCompleted.Provides data for the ResolveAddressCompleted event.

Интерфейсы

ICivicAddressResolver

Предоставляет метод, который, будучи реализованным, разрешает выраженное в виде широты и долготы расположение в административный адрес.Provides a method that when implemented, resolves a latitude/longitude location to a civic address.

IGeoPositionWatcher<T>

Интерфейс, который можно реализовать для предоставления доступа к данным расположения и получения обновлений расположения.Interface that can be implemented for providing accessing location data and receiving location updates.

Перечисления

GeoPositionAccuracy

Указывает требуемый уровень погрешности для данных расположения, используемых приложением.Specifies the requested accuracy level for the location data that the application uses.

GeoPositionPermission

Указывает, есть ли у вызывающего приложения разрешение на доступ к данным расположения.Indicates whether the calling application has permission to access location data.

GeoPositionStatus

Указывает, способен ли поставщик расположения передавать обновления расположения.Indicates the ability of the location provider to provide location updates.

Комментарии

GeoCoordinateWatcher Класс предоставляет данные о расположении, основанные на координатах широты и долготы.The GeoCoordinateWatcher class supplies location data that is based on latitude and longitude coordinates. Типы CivicAddressResolver иICivicAddressResolver предоставляют возможность разрешения из координатного расположения в административный адрес.The CivicAddressResolver and ICivicAddressResolver types provide the ability to resolve from a coordinate location to a civic address. Кроме того, IGeoPositionWatcher<T> интерфейс можно реализовать для расширения типов предоставляемых данных расположения.Additionally, the IGeoPositionWatcher<T> interface can be implemented to extend the types of location data that are supplied.

В Windows 7 все System.Device.Location классы полностью функционируют, если установлен поставщик расположения и может определить расположение компьютера.In Windows 7, all the System.Device.Location classes are fully functional if a location provider is installed and can determine the computer's location. В Windows 7 Starter Edition поставщик расположения по умолчанию, который можно задать в панели управления, является единственным поддерживаемым поставщиком расположения.On Windows 7 Starter Edition, the Default Location Provider that can be set in Control Panel is the only location provider that is supported.

Примечание . В версиях Windows, предшествовавших Windows 7, применяются следующие условия.Note In versions of Windows prior to Windows 7, the following conditions apply:

  • Все System.Device.Location объекты, имеющие конструкторы, могут быть созданы, Status но свойство всегда будет иметь значение Disabled.All System.Device.Location objects that have constructors can be created, but the Status property will always have the value Disabled.

  • Расположение, Location указанное Position свойством, всегда будет иметь Unknownзначение.The location indicated by the Location property of Position will always be Unknown.

  • События расположения не будут вызываться.No location events will be raised.