MapPoint之旅（2）-----Getting Started with MapPoint Web Service(1)

Getting Started with MapPoint Web Service Version 3.5

by Laura Flanders, Microsoft Corporation  译： 涟漪勇 

MapPoint是微软公司的一项业务，提供基于XML的Web服务。开发者可以集成其提供基于位置的服务（例如：地图、驾驶指南和近似搜索） 到自己的应用和业务进程。当你在任何微软或者微软合作伙伴的网站上使用 地图或者导航服务的时候,幕后使用的就是MapPoint Web服务，在为用户提供所需的信息。

 

微软公司MapPoint Web服务3.5 版本是MapPoint Web服务的最新的版本。新的MapPoint Web服务用户能开发基于这个平台的应用程序。MapPoint Web服务早期版本的用户可以自动升级他们基于位置的服务程序到MapPoint Web服务3.5 版本，并且可以完全兼容以前版本和使用许多新的特性。

 

在一个企业里实现MapPoint Web服务需要许多工作，包括一个开发中的应用程序，准备订制的数据和图标，跟踪你的应用程序的需求,不断形成的数据的管理。大多数这些工作，例如开发中的应用程序和准备订制你的数据，可以被一并完成。这篇文章提供了开始WapPoint Web服务的必要的工作的概述。

开发你的 MapPoint WEb 服务应用程序

如果你是第一次创建MapPoint Web服务应用程序的新用户,在你或者你的开发团队建立应用程序之前，你必须决定你的用户将能够处理怎样的应用程序。你想在你提供的地图上标明你的位置吗?  提供路线指南吗？允许你的用户寻找附近位置吗？如果你已经有MapPoint Web服务应用程序的用户,可以查看 MapPoint Web服务 3.5的特征和增前，看看那些是对你现有的应用程序有用的。

MapPoint Web服务API由4 种服务组成

• Common service提供其它服务使用的有效的类，方法和特性
• Find service提供的功能是查找地址，兴趣热点，得到的位置信息包括准确的纬度和经度坐标。你可以查找一个服务在一个具体的点附近或者沿着一条路线。如果你是个熟悉MapPoint Web服务的开发者也许你会对两个新的查找方法感兴趣，FindByID 和FindByProperty。那允许你查找位置通过实体的ID或者 property此外，在3.5 版本内还包括FindNearRoute ，在查找你的位置是包含在一段指定的距离内的路线。
• Render service 提供的功能是回馈地图信息包括你的路线和位置，你可以设置地图的尺寸，视图，你可以控制和增加标记在上面。如果你使用客户服务网站上传自定义的图象，在地图上也可以很好的显示，这次发布的新版本可以回馈的地图可以使用在小屏幕设备像Phone和 PhoneBW 地图风格。
• Route service提供的功能是提供驾驶指南和路线，设置waypoints，并且生成路线的地图参考意见。

另外， MapPoint Web服务3.5 包括新的API，自定数据服务（Customer Data Service）一个通过MapPoint Web服务的客户服务站点(CSS)的Web服务，通过SOAP API，你可以上传你自己定义的位置数据信息到Mappoint Web服务的服务表中。在SDK中包含一个客户端上传数据的例子，其中显示了你如何用客户数据服务去处理用文件命令行执行一批文件上传到你的自定数据列表中。

如果你开发程序是基于微软的.NET框架，你可以下载相应版本的MapPoint Web Service SDK嵌入到你的Microsoft Visual Studio .NET帮助文档中去（在下SDK前你的Visual Studio .NET和.NET Framework version 1.1必须安装）。并不要求开发者必须基于.NET框架开发应用程序，为什么？因为MapPoint Web服务是基于SOAP的，你可以开发你的应用程序使用任何符合SOAP的语言，例如Java1.4用Axis Library。应此SDK没使用对于Visual Studio .NET的开发者来说以HTML 形式。更多的信息关于MapPoint Web Service API，开发者可以访问 MapPoint Web Service Software Development Kit (SDK), Version 3.5

 

MapPoint Web服务提供两种统一，但又是独立的环境。 你能使用staging环境开发和测试你的的应用程序。当你的应用程序准备发布给用户的时候，你可以移到production环境。

测试你的应用程序在工作台环境通过访问staging MapPoint  Web 服务定义语言(WSDL)文件，为了staging这里有标准的标准(HTTP) URL 和 an加密 (HTTPS) URL

• 标准 WSDL: http://staging.mappoint.net/standard-30/mappoint.wsdl.
• 加密 WSDL: https://staging.mappoint.net/secure-30/mappoint.wsdl.

 

在使用MapPoint Web Service 3.0时WSDL的URLS是现同的和MapPoint Web服务3.5，为了可以使用新的API特性，刷新你的WSDL文件在你的开发环环境，对于新Customer Data Service API是访问你的CSS证书，不是你的Web服务正书，WSDL的URL在下面：

 

https://mappoint-css.partners.extranet.microsoft.com/CustomerData-30/CustomerDataService.wsdl.

更多的关于测试用的信息，可以参看CSS版主标题“About Testing Your Application “

如果你是一个新用户，当你的应用程序在开发时，确保客户服务站点(CSS)使用在你收到的欢迎电子邮件消息里供给你的证书里面，在你的主页上，点击Verify Credentials，下面的说明在Verify Credentials 页面上，因为MapPoint Web服务3.5是可以向下兼容的版本，已有的用户可以继续使用他们的MapPoint Web Service 3.0证书。

Note Evaluation account customers cannot access the MapPoint Web Service production environment. If you try to access MapPoint Web Service using the production Web Services Description Language (WSDL) file, your application will fail with a 401 error, even if your credentials are valid on the Verify Credentials page.

 

to be  continue......
原文：Started with MapPoint Web Service Version 3.5