Overview  |  API  |  Data Structures  |  Parameters  |  Example Map

TerraServer-USA .NET Web Service 2.0 Changes

TerraService 2.0 differs from the original TerraService implementation in one significant way: the data-type for the data Theme field and parameter is an Int32 type instead of a enum type. New data themes could not be easily added to the original TerraServer Web Service (TerraService.asmx) because the theme parameter and field was implemented an enum type. Adding a new theme would force all client application to be recompiled even if they were not interested in the Urban Area data theme.

To minimize the impact on our web service users, we implemented a new web service, TerraService2.asmx, and changed the Theme field/parameter to be an integer type. To use the version 2 web service, you will have to do the following:

1. Re-compile your application using the TerraService2.asmx WSDL file. For Microsoft Visual Studio.NET users, delete your current web reference to the TerraService and add http://terraserver-usa.com/TerraService2.asmx
2. The Theme parameter is an Int32 type in all TerraService 2.0 method calls. You will have to change your application code to pass an integer value for the Theme value.
3. The Theme field is an Int32 type in all the data structures returned by TerraService 2.0 method calls. You will have to change your application code to use the Theme field returned from TerraService calls as Int32 type.
4. The Theme enum values are mapped to the following integer values: Theme.Photo is 1, Theme.Topo is 2, and Theme.Relief. The Urban Area theme is 4.

If you have any issues using the TerraService2.asmx file, please send a message to us at TerraServer mailbox.