Open topic with navigation

Using the World Geocoding subscription

The World Geocoding subscription provides online locator and place finding capabilities published and hosted by ESRI. The address locators are based on Tele Atlas 2009 Q2 reference data for North America and Tele Atlas 2009 Q1 reference data for Europe. The street locator is based on Tele Atlas 2009 Q2 reference data for the United States. The place finder is based primarily on the June 2009 GeoNames Data. The tasks support single address, reverse, and batch geocoding for more than 1,000 batch geocodes in a year. You need ArcGIS 9.3 or higher to be able to use the ArcGIS Online World Geocoding subscription.

The following online geocoding tasks are available with the World Geocoding subscription:

• ESRI_Places_World: Use the World Places Locator to geocode world places including countries, states and provinces, administrative areas, cities, landmarks, water bodies, and more.
• TA_Address_EU: Use the European Address Locator to geocode street addresses in Europe including street address, street name, city, and postal code. See European Country Codes for a list of valid inputs for the Country field.
• TA_Address_NA: Use the North American Address Locator to geocode street addresses in the United States and Canada including street address, ZIP/postal code, city/state or city/province, and more.
• TA_Streets_US: Use the United States Street Locator to geocode street addresses in the United States.
• TA_BatchAddress_EU: Use the European Address Locator to batch geocode street addresses in Europe. See European Country Codes for a list of valid inputs for the Country field.
• TA_BatchAddress_NA: Use the North American Address Locator to batch geocode street addresses in the United States and Canada.

After you activate your subscription for World Geocoding, see the appropriate section below and follow the instructions to get started using the content:

• ArcGIS Desktop
• ArcGIS Server Manager .NET
• ArcGIS Server Web ADF
• ArcGIS APIs

ArcGIS Desktop

To connect to the subscription ArcGIS Online locators in ArcGIS Desktop use the URL: http://premiumtasks.arcgisonline.com/desktop/services.

To add an ArcGIS Online address locator to an ArcMap document:

1. Click the Tools menu, point to Geocoding, then click Address Locator Manager.
2. Click Add in the Address Locator Manager dialog box.
3. In the Look in drop-down menu, select GIS Servers, click Add ArcGIS Server to highlight it, and click Add.
4. In the Add ArcGIS Server wizard, Select Use GIS Services and click Next.
5. Select Internet and enter the following Server URL: http://premiumtasks.arcgisonline.com/desktop/services.
6. Under Authentication, enter the ESRI Global Account username and password that was activated for the subscription service.
   NOTE: Your ESRI Global Account username and password are case sensitive.
7. Click Finish.
   
8. In the ArcGIS Server list, select "desktop on premiumtasks.arcgisonline.com" and click Add.
9. Select the Locators folder and click Add.
10. Select the locator you want to add to the ArcMap document and click Add.
11. Click Close.

For information on using the ArcGIS Online locators in ArcMap, see About managing address locators in ArcGIS Desktop Help.

ArcGIS Server Manager .NET

To connect to ArcGIS Server Manager .NET, use the URL: http://premiumtasks.arcgisonline.com/server/services.

To use ArcGIS Online locators with ArcGIS Server Manager .NET:

1. In the Web Manager, create a web application, and click Add Task to add a new task.
2. Under Available Tasks, select Find Address, and click OK.
3. With Find Address selected, click Supporting Services.

   

4. Click Add in the Supporting Services dialog box.
5. Select Add GIS Server.
6. In the Add Server dialog box:
   1. In the Type drop-down menu, select ArcGIS Server Internet.
   2. Enter the following for the Catalog URL: http://premiumtasks.arcgisonline.com/server/services
   3. Under Access secured services, enter your ESRI Global Account information that was activated for the World Geocoding subscription.

      NOTE: Your ESRI Global Account username and password are case sensitive.

   4. Click Add to add the connection to the ArcGIS Online task server.
7. In the Available Services dialog box:
   1. In the Layers in drop-down menu, select the Locators folder.
   2. Select the Geocode Service you want to use in your web application, for example, ESRI_Places_World.
   3. Click OK.

      

   The Geocode Service displays in the Supporting Services dialog box.

8. If you want to set a task name, click Configure. Enter a Task Name, Button Text, and a Help Tip if desired.

   

For information on using the ArcGIS Online locators with the ArcGIS Server Manager .NET, see the About publishing a GIS resource to the server and About the Find Address task topics in ArcGIS Server .NET Help.

ArcGIS Server Web ADF

To connect to ArcGIS Server Web ADFs, use the URL: http://premiumtasks.arcgisonline.com/server/services.

When building a custom application using software such as Microsoft Visual Studio, the locator is added through the Geocode Resource Manager.

1. In the Geocode Resource Manager, add a GeocodeResourceItem Collection Editor.
2. Click Add to add a GeocodeResourceItem to the collection.
3. Set the definition data source in the Geocode Resource Definition Editor:
   1. In the Type drop-down menu, select ArcGIS Server Internet.
   2. Enter the following for the Data Source: http://premiumtasks.arcgisonline.com/server/service
   3. For Identity, click the button and enter your ESRI Global Account information that was activated for the World Geocoding subscription for the username and password. Once complete, the Identity will be populated.

   NOTE: Your ESRI Global Account username and password are case sensitive.

   4. For Resource, click the button and select the desired task in the Locators folder, for example, ESRI_Places_World.
   5. Click OK.
4. Add a FindAddressTask for the new GeocodeResourceItem.
5. Configure the Find Address Properties for the new FindAddressTask resource.

For information on using the ArcGIS Online locators with the ArcGIS Server Web ADF, see the documentation for your Web ADF.

ArcGIS APIs

ArcGIS API for Flex, JavaScript , Silverlight, mobile, and REST users should use the following server connection for Web applications: http://premiumtasks.arcgisonline.com/server/rest

ArcGIS Server SOAP API users should use the following server connection for Web applications: http://premiumtasks.arcgisonline.com/server/services

To use your subscription with ArcGIS Flex, JavaScript , and REST APIs:

1. To see the content available with the World Geocoding subscription, use the following URL: http://premiumtasks.arcgisonline.com/server/rest. When you are prompted for a username and password, use your ESRI Global Account that was activated for the subscription.
   NOTE: Your ESRI Global Account username and password are case sensitive.
2. Obtain a Development API Key (token) to use the World Geocoding subscription in your ArcGIS API applications.

3. To include the Development API Key (token) in your application, append the token to your URL. For example:
   http://premiumtasks.arcgisonline.com/server/rest/TA_Address_EU/GeocodeServer?token=abcdefg

   Replace abcdefg with the Development API Key (token) you obtained in step 2.

For information on using the ArcGIS Online locators with an ArcGIS API, see the documentation for the appropriate API:

• ArcGIS API for Flex
• ArcGIS API for JavaScript
• ArcGIS API for Silverlight
• ArcGIS Server REST API
• ArcGIS Server SOAP API
• Mobile APIs