Share via


V2 User Plane Location (V2 UPL)

For CDMA phones, you can configure the phone to use V2 UPL (V2 User Plane Location) for Assisted GPS (A-GPS). V2 UPL support includes:

  • Configuration

  • Support Network Initiated Immediate Request.

  • Multiple auth types: notify only, notify and verify, etc, with integration to the UI for user notification and action validation.

  • Mobile Originated Positioning Requests, for different positioning methods (MS-A, MS-B, AFLT).

  • Non trusted mode.

The following sample shows how to configure V2 UPL account.

<Settings Path="Location/V2UPL1">
    <Setting Name="MPC" Value="192.0.2.1:7777" />
    <Setting Name="PDE" Value="192.0.2.1:7778" />
    <Setting Name="PositioningMethod" Value="0" />
    <Setting Name="NIDependencyOnLocationMasterSwitch" Value="1" />
</Settings>

Note  

Only one V2 UPL account is supported at a given time.

Settings

  • MPC
    Optional. The address of the mobile positioning center (MPC), in the format ipAddress: portNumber. For non-trusted mode of operation, this parameter is mandatory and the PDE parameter must be empty.

  • PDE
    Optional. The address of the Position Determination Entity (PDE), in the format ipAddress: portNumber. For non-trusted mode of operation, this parameter must be empty.

  • NIDefaultTimeout
    Optional. Time in seconds that the network-initiated location request is displayed to the user, while awaiting a response and before doing the default action. The default is 30 seconds. A value between 20 and 60 seconds is recommended.

    This value manages the settings for both SUPL and v2 UPL. If a phone is configured for both SUPL and V2 UPL and these values differ, the SUPL setting will always be used.

    For more information about user notifications for location requests, see User notifications for location requests.

  • ServerAccessInterval
    Optional. Integer. Defines the minimum interval of time in seconds between mobile originated requests sent to the server to prevent overloading the mobile operator's network. The default value is 60.

  • PositioningMethod
    Optional. Specifies the positioning method that is used for mobile originated position requests. The value can be one of the following integers:

    Value Description

    0

    None: The phone uses the default positioning method. In this default mode, the GNSS obtains assistance (time injection, coarse position injection and ephemeris data) from the Microsoft Positioning Service.

    1

    Mobile Station Assisted: The phone contacts the server to obtain a position. The server does the calculation of the position and returns it to the phone.

    2

    Mobile Station Based: The phone obtains location-aiding data (almanac, ephemeris data, time and coarse initial position of the phone) from the server, and the phone uses this information to help GPS obtain a fix. All position calculations are done in the phone.

    3

    Mobile Station Standalone: The phone obtains assistance as required from the Microsoft location services.

    4

    AFLT

     

    The default is 0. The default method in Windows Phones provides high-quality assisted GNSS positioning for mobile originated position requests without loading the mobile operator’s network or location services. For more information, see Location Framework overview.

    Important  

    The Mobile Station Assisted and AFLT positioning methods must only be configured for test purposes.

  • NIDependencyOnLocationMasterSwitch
    Optional. Boolean. Specifies whether the location toggle on the location screen in Settings is also used to manage network-initiated (NI) requests for location. If the value is set to 0, the NI behavior is independent from the current location toggle setting. If the value is set to 1, the NI behavior follows the current location toggle setting. For CDMA phones, this value must be set to 1. The default value is 1.

    This value manages the settings for both SUPL and v2 UPL. If a phone is configured for both SUPL and V2 UPL and these values differ, the SUPL setting will always be used.

    Location toggle setting NIDependencyOnLocationMasterSwitch setting NI request processing allowed

    On

    0

    Yes

    On

    1

    Yes

    Off

    0

    Yes

    Off

    1

    No (unless privacyOverride is set)

     

    When the location toggle is set to Off and this value is set to 1, the following application requests will fail:

    • noNotificationNoVerification

    • notificationOnly

    • notificationAndVerficationAllowedNA

    • notificationAndVerficationDeniedNA

    However, if privacyOverride is set in the message, the location will be returned.

    When the location toggle is set to Off and this value is set to 0, the location toggle does not prevent network-initiated requests from working.

    For more information about user notifications for location requests, see User notifications for location requests.

User Plane Location configuration service provider

 

 

Send comments about this topic to Microsoft