位置 (GPS)

类型 事件
版本 版本 2024.3703
关键词 位置, GPS

概述

这些是由 GPS 硬件生成的位置事件。仅当应用程序使用如下语句请求它们时，它们才会发送到全局 Runtime 对象：Runtime:addEventListener( "location", locationHandler ).

有关示例，请参阅下面的各个属性文档页面。

注意事项

通用

在位置事件监听器中，应检查 event.errorCode 以防出现位置错误。

Android

要在 Android 设备上启用 GPS，您必须将以下权限添加到 build.settings 文件中

settings =
{
    android =
    {
        usesPermissions =
        {
            -- Permission to retrieve current location from the GPS
            "android.permission.ACCESS_FINE_LOCATION",
            -- Permission to retrieve current location from WiFi or cellular service
            "android.permission.ACCESS_COARSE_LOCATION",
        },
    },
}

iOS

在 iOS 上，如果用户禁用了应用程序的位置服务，则 event.errorCode 将非`nil`。

macOS

您必须调整应用程序的授权才能将位置事件用于 macOS 应用程序。有关详细信息，请参阅此处。

Windows

Windows 当前不支持位置服务。虽然 Windows 版 Corona 模拟器会合成一个假的定位事件用于测试目的，但 Windows 桌面应用程序**不会**这样做。因此，system.hasEventSource( "location" )在 Windows 版 Corona 模拟器中将返回 `true`，但在 Windows 桌面应用程序中将返回 `false`。

属性

event.accuracy

event.altitude

event.direction

event.errorCode

event.errorMessage

event.latitude

event.longitude

event.name

event.speed

event.time