Chapter 3: Adding Providers

Two providers that work with mobile operator networks are available with Microsoft® MapPoint® Location Server:

  • Bell Mobility—A location provider that works with the Bell Mobility network.

  • Teydo—A location provider and a Short Message Service (SMS) notification provider that works with the Teydo network.

If you have a MapPoint Web Service account, you can download these providers from the MapPoint Web Service Customer Services site, a secure Web site that is located on the Microsoft extranet. For more information about how to obtain a MapPoint Web Service account, see this page on microsoft.com.

This section describes how to install and uninstall the Bell Mobility and Teydo providers.

*

On This Page

Bell Mobility Bell Mobility
Teydo Teydo

Bell Mobility

This section provides information about installing the Bell Mobility location provider for MapPoint Location Server. This information is specific to the Bell Mobility location provider and does not work with providers for other mobile operators.

Prerequisites

Microsoft MapPoint Location Server must be successfully installed before you install the Bell Mobility location provider.

You'll also need the following information from Bell Mobility:

  • Bell Mobility Client ID—Required for authentication location requests.

  • Bell Mobility Password—Required for authenticating location requests.

  • Bell Mobility Originator ID—Required for billing purposes.

  • Bell Mobility Location Service URL—Required for sending the location requests to Bell Mobility.

  • Maximum Processing Devices—Indicates the maximum concurrent location requests that Bell Mobility accepts as part of your contract with Bell Mobility.

  • Maximum Queued Devices—Indicates the maximum number of requests that Bell Mobility places in a queue if the concurrent location requests exceed the limit specified by Maximum Processing Devices. This number depends on your contract with Bell Mobility.

Installing the Bell Mobility Location Provider

When you install the Bell Mobility location provider, you'll need to specify settings for location accuracy (horizontal accuracy) and response time.

You specify location accuracy in the Horizontal Accuracy text box:

  • If you have no restrictions on the accuracy of the locations returned by the Bell Mobility location provider, leave the Horizontal Accuracy text box empty.

  • If you have a minimal restriction on the accuracy of the locations returned by the Bell Mobility location provider, set Horizontal Accuracy to a value between 50 and 5,000 meters. For example, setting the value to 1,000 meters means that you want a location to be returned only if it is accurate to within a 1,000 meter (or smaller) radius of the actual location.

  • If you want faster response times for your location requests, set the horizontal accuracy to 5,001 meters.

Response time is expressed in seconds and must be a value between 1 and 60. The recommended value is 30 seconds.

Set a higher value for the response time if you request more accurate locations. For example, if you set the horizontal accuracy to 200 meters (a high degree of accuracy), set the response time to 45 seconds (a longer delay).

To install the Bell Mobility location provider

  1. Double-click the Setup.exe file.

  2. When the InstallShield Wizard starts, click Next, read the end-user license agreement, and then click Yes to proceed.

  3. In the Bell Mobility Application Information dialog box, provide the following information from Bell Mobility:

    • In Bell Mobility Client ID, type your Bell Mobility client ID.

    • In Bell Mobility Password, type your Bell Mobility password.

    • In Bell Mobility Originator ID, type your Bell Mobility originator ID.

    • In Horizontal Accuracy, specify the acceptable accuracy in meters. The default value is 300 meters.

    • In Minimum Acceptable Accuracy, leave the default value. This field is reserved for future use.

    • In Response Time, specify the acceptable response time for the Bell Mobility location provider.

    • In Bell Mobility Location Service URL, specify the URL for the Bell Mobility location service.

    • In Maximum Processing Devices, specify the number of devices suggested by Bell Mobility. The default value is 5.

    • In Maximum Queued Devices, specify the number of devices suggested by Bell Mobility. The default value is 5.

  4. Click Next to review the settings, and then click Next to start the installation. If you want to change the settings, click Back.

  5. When Setup completes, click Finish.

Uninstalling the Bell Mobility Location Provider

You can uninstall the Bell Mobility Provider by using Add/Remove Programs in Control Panel.

Caution  When you uninstall a provider, all provisioned users who are associated with that provider lose the association and as a result, cannot locate themselves. MapPoint Location Server does not provide a mechanism for re-associating providers with more than one provisioned user at a time, so if you plan to add a new provider, each provisioned user who is not associated with a provider association must be reconfigured individually.

In addition, when you uninstall a provider, all custom properties that you have created in the MapPoint Location Server management console are lost. You must re-create the properties after installing a new provider.

To uninstall the Bell Mobility location provider

  1. In Control Panel, double-click Add/Remove Programs, click Microsoft MapPoint Location Server – Bell Mobility Provider 1.0, and then click Change/Remove.

    The following message is displayed: "Are you sure you want to completely remove Microsoft MapPoint Location Server – Bell Mobility Provider 1.0 and all of its components?"

  2. To continue, click OK, or to cancel, click Cancel.

  3. If you click OK, the InstallShield Wizard starts and removes all MapPoint Location Server Bell Mobility Provider components from the computer.

  4. When the wizard completes the uninstallation process, click Finish.

Teydo

This section provides information about installing the Teydo location provider and notification provider for MapPoint Location Server. This information is specific to the Teydo providers and does not work with providers for other mobile operators.

Prerequisites

Microsoft MapPoint Location Server must be successfully installed before you install the Teydo location and notification providers. You'll also information from Teydo.

The following LBS gateway information is required:

  • Username—Required for authenticating location requests.

  • Password—Required for authenticating location requests.

  • AccountRef—Required for billing purposes.

  • Teydo LBS Gateway URL—Required for sending the location requests to Teydo.

  • Maximum Processing Devices—Indicates the maximum concurrent location requests that Teydo accepts as part of your contract with Teydo.

  • Maximum Queued Devices—Indicates the maximum number of requests that Teydo accepts to queue as part of your contract, if the concurrent location requests have exceeded the limit specified by the Maximum Processing Devices.

The following SMS gateway information is required:

  • Username—Required for authenticating SMS requests.

  • Password—Required for authenticating SMS requests.

  • AccountRef—Required for SMS billing purposes.

  • Teydo SMS Gateway URL—Required for sending the SMS requests to Teydo.

Installing the Teydo Providers

When you install the Teydo providers you'll need to supply an operator (or codes). Table 1 lists the operator codes that you can use with the Teydo providers.

Table 2. Operator codes

Code

Description

Country/region

O2

Recipient handset subscribed to O2

United Kingdom

TM

Recipient handset subscribed to T-Mobile

United Kingdom

VF

Recipient handset subscribed to Vodafone

United Kingdom

DF

Recipient handset subscribed to Digifone (O2)

Ireland

EC

Recipient handset subscribed to Eircell (Vodafone)

Ireland

To install the Teydo location provider and notification provider

  1. Double-click the Setup.exe file.

  2. When the InstallShield Wizard starts, click Next, read the end-user license agreement, and then click Yes to proceed.

  3. In the Teydo Application Information dialog box, provide the following LBS gateway information from Teydo, and then click Next:

    • In Username, type your Teydo user name.

    • In Password, type your password.

    • In AccountRef, type your Teydo billing account number.

    • In Teydo LBS Gateway URL, type the URL for the Teydo location service.

    • In Maximum Processing Devices, specify the number of devices as suggested by Teydo. The default value is 5.

    • In Maximum Queued Devices, specify the number of devices as suggested by Teydo. The default value is 5.

    • Leave the default value for Request Timeout. The default value is 60,000 milliseconds (60 seconds).

    • Type the operator codes in the appropriate text box, and then click Next. (If you have more than one operator, separate the values with a comma.)

      Note: For operator codes, see section 6.1.

  4. In the SMS Information dialog box, provide the following SMS gateway information from Teydo, as noted in section 2.0:

    • In SMS Gateway URL, type the URL for the Teydo SMS service.

    • In Username, type your Teydo SMS user name.

    • In Password, type your Teydo SMS password.

    • In AccountRef, type your Teydo SMS billing account number.

    • In Teydo LBS Gateway URL, type the URL for the Teydo location service.

    • In SMS Sender Address, type an alphanumeric string that is between 3 and 16 characters long. This field is used as the SMS sender’s display name.

  5. Click Next to review the Teydo location and notification provider settings, and then click Next to start the installation. If you want to change the settings, click Back.

  6. When Setup completes, click Finish.

Uninstalling the Teydo Providers

You can uninstall the Teydo providers by using Add/Remove Programs in Control Panel.

Caution  When you uninstall a provider, all provisioned users who are associated with that provider lose the association and as a result, cannot locate themselves. MapPoint Location Server does not provide a mechanism for re-associating providers with more than one provisioned user at a time, so if you plan to add a new provider, each provisioned user who is not associated with a provider association must be reconfigured individually.

In addition, when you uninstall a provider, all custom properties that you have created in the MapPoint Location Server management console are lost. You must re-create the properties after installing a new provider.

To uninstall the Teydo location and notification providers

  1. In Control Panel, double-click Add/Remove Programs.

  2. Click Microsoft MapPoint Location Server – Teydo Provider 1.0, and then click Change/Remove.

    The following message is displayed: "Are you sure you want to completely remove Microsoft MapPoint Location Server – Teydo Provider 1.0 and all of its components?"

  3. To continue, click OK, or to cancel, click Cancel.

  4. If you click OK, the InstallShield Wizard starts and removes all MapPoint Location Server Teydo provider components from the computer.

  5. When the wizard completes the uninstallation process, click Finish.