RemoteFind 云解决方案提供商RemoteFind CSP

RemoteFind 配置服务提供程序检索特定设备的位置信息。The RemoteFind configuration service provider retrieves the location information for a particular device.

下面以树格式显示由 OMA 客户端预配使用的 RemoteFind 配置服务提供程序管理对象。The following shows the RemoteFind configuration service provider management object in tree format as used by OMA Client Provisioning.

./Vendor/MSFT
RemoteFind
----DesiredAccuracy
----MaximumAge
----Timeout
----Location
--------Latitude
--------Longitude
--------Altitude
--------Accuracy
--------AltitudeAccuracy
--------Age

DesiredAccuracyDesiredAccuracy
可选。Optional. 节点接受请求的半径值(以米为单位)。The node accepts the requested radius value in meters. 精度的有效值是 1 到 1000 米之间的任意值。Valid values for accuracy are any value between 1 and 1000 meters.

默认值为 50。The default value is 50. 替换此值只会替换当前会话的值。Replacing this value only replaces it for the current session. 该值不会保留。The value is not retained.

支持的操作包括 Replace 和 Get。Supported operations are Replace and Get. 不支持 Add 命令。The Add command is not supported.

超时Timeout
可选。Optional. 值为 DWORD(以秒表示)。Value is DWORD in seconds.

默认值为 7,范围为 0 到 1800 秒。The default value is 7, and the range is 0 to 1800 seconds. 替换此值只会替换当前会话的值。Replacing this value only replaces it for the current session. 该值不会保留。The value is not retained.

支持的操作包括 Replace 和 Get。Supported operations are Replace and Get. 不支持 Add 命令。The Add command is not supported.

MaximumAgeMaximumAge
可选。Optional. 值表示服务器将接受成功位置检索的所需时间窗口(分钟)。The value represents the desired time window in minutes that the server will accept a successful location retrieval. 节点使服务器能够将请求的年龄值设置为 100 纳秒。The node enables the server to set the requested age value in 100 nanoseconds. 精度的有效值包括 0 到 1440 分钟之间的任意整数值。Valid values for accuracy include any integer value between 0 and 1440 minutes.

默认值为 60。The default value is 60. 替换此值只会替换当前会话的值。Replacing this value only replaces it for the current session. 该值不会保留。The value is not retained.

支持的操作包括 Replace 和 Get。Supported operations are Replace and Get. 不支持 Add 命令。The Add command is not supported.

位置Location
必需。Required. 必须按原子方式查询此路径下的节点才能成功。Nodes under this path must be queried atomically in order to succeed. 这是为了防止服务器查询不完整的数据集。This is to prevent servers from querying incomplete sets of data.

LatitudeLatitude
必需。Required. 提供上次成功远程查找的纬度。Provides the latitude of the last successful remote find.

返回的值是 double。The value returned is double.

默认值为 Null。The default value is Null.

支持的操作为 Get。Supported operation is Get.

经度Longitude
必需。Required. 提供上次成功远程查找的经度。Provides the longitude of the last successful remote find.

返回的值是 double。The value returned is double.

默认值为 Null。The default value is Null.

支持的操作为 Get。Supported operation is Get.

AltitudeAltitude
必需。Required. 提供上次成功远程查找的高度。Provides the altitude of the last successful remote find.

返回的值是 double。The value returned is double.

默认值为 Null。The default value is Null.

支持的操作为 Get。Supported operation is Get.

准确性Accuracy
必需。Required. 提供最近一次成功远程查找的位置修复的精度(以米为单位)。Provides the accuracy in meters of the location fix of the last successful remote find. 值范围为 0 – 1000 米。Values range from 0 – 1000 meters.

返回的值是一个整数。The value returned is an integer.

默认值为 0。The default value is 0.

支持的操作为 Get。Supported operation is Get.

AltitudeAccuracyAltitudeAccuracy
必需。Required. 提供最后一次成功远程查找的位置修复的海拔精度(以米为单位)。Provides the altitude accuracy in meters of the location fix of the last successful remote find. 值范围为 0 – 1000 米。Values range from 0 – 1000 meters.

返回的值是一个整数。The value returned is an integer.

默认值为 0。The default value is 0.

支持的操作为 Get。Supported operation is Get.

AgeAge
必需。Required. 提供当前位置数据的使用时间(以 100 纳秒为单位)。Provides the age in 100 nanoseconds for current location data.

返回的值是一个整数。The value returned is an integer.

默认值为 0。The default value is 0.

支持的操作为 Get。Supported operation is Get.

示例Examples

<SyncML xmlns="SYNCML:SYNCML1.2">
    <SyncBody>
        <Atomic>  
            <CmdID>1</CmdID>  
            <Sequence> 
                <CmdID>10</CmdID>  
                <Get>         
                    <CmdID>30</CmdID>  
                    <Item>  
                        <Target>  
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Latitude</LocURI>  
                        </Target>  
                    </Item>  
                </Get> 
                <Get> 
                    <CmdID>40</CmdID>  
                    <Item>  
                        <Target>  
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Longitude</LocURI>  
                        </Target>  
                    </Item>  
                </Get> 
                <Get> 
                    <CmdID>40</CmdID>  
                    <Item>  
                        <Target>  
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Altitude</LocURI>  
                        </Target>  
                    </Item>  
                </Get> 
                <Get> 
                    <CmdID>45</CmdID>  
                    <Item>  
                        <Target>  
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Accuracy</LocURI>  
                        </Target>  
                    </Item>  
                </Get> 
                <Get> 
                    <CmdID>50</CmdID>  
                    <Item>  
                        <Target>  
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/AltitudeAccuracy</LocURI>  
                        </Target>  
                    </Item>  
                </Get> 
                <Get> 
                    <CmdID>60</CmdID>  
                    <Item>  
                        <Target>  
                            <LocURI>./Vendor/MSFT/RemoteFind/Location/Age</LocURI>  
                        </Target>  
                    </Item>  
                </Get>                  
            </Sequence> 
        </Atomic> 
    </SyncBody>
</SyncML>

配置服务提供程序参考Configuration service provider reference