1 什么是网络服务?
Google Maps API 提供这些网络服务作为从外部服务中请求 Google Maps API 数据以及在您的地图应用程序中使用它们的接口。这些网络服务使用特定网址的 >
一个典型的网络服务请求通常采用以下形式:
htt p:/ /mapsg oogl eco m/maps/api/service/outputparameters
其中 service 表示所请求的特定服务,output 表示响应格式(通常为 json 或 xml)。
2地址解析与反地址解析
地址解析是将地址(如“1600 Amphitheatre Parkway, Mountain View, CA”)转换为地理坐标(如纬度 37423021 和经度 -122083739)的过程,您可以根据转换得到的坐标放置标记或定位地图。Google Geocoding API 可让您通过 >
3 地址查询(反向地址解析)请求
Google Geocoding API 请求必须采用以下形式:
htt p:/ /mapsg oogl ec om/maps/api/geocode/outputparameters
其中,output 可以是以下值之一:
json(建议)表示以 JavaScript 对象表示法 (JSON) 的形式输出
xml 表示以 XML 的形式输出
有些参数是必需的,有些是可选的。根据网址的标准,所有参数均使用字符 & (&) 分隔。下面枚举了这些参数及其可能的值。
Google Geocoding API 使用以下网址参数定义地址查询请求:
latlng(必需)- 您希望获取的、距离最近的、可人工读取地址的纬度/经度文本值。
bounds(可选)- 要在其中更显著地偏移地址解析结果的可视区域的边框。
region(可选)- 区域代码,指定为 ccTLD(“顶级域”)双字符值。
language(可选)- 传回结果时所使用的语言。请注意,我们会经常更新支持的语言,因此该列表可能并不详尽。如果未提供 language,地址解析器将尝试尽可能使用发送请求的区域的本地语言。
sensor(必需)- 指示地址解析请求是否来自装有位置传感器的设备。该值必须为 true 或 false。
注意:bounds 和 region 参数只会影响地址解析器返回的结果,但不能对其进行完全限制。
实例一:创建查询坐标(39910093,116403945)的地址信息的请求,要求以xml格式输出响应,语言为简体中文(zh-CN)。
注意:经纬度书写的顺序为(纬度,经度)。
实例二:利用C#在客户端程序中创建上述请求。
1 WebClient client = new WebClient();
2 string url = "htt p:/ /m apsg oogl eco m/maps/api/geocode/xm llatln g=39910 093,116403945&language=zh-CN&sensor=false";
3 clientEncoding = EncodingUTF8;
4 string responseTest = clientDownloadString(url);
5 地址查询(反向地址解析)响应
地址解析响应将以网址请求路径中的 output 标记所指示的格式传回。XML 响应包含一个 <GeocodeResponse>和两个顶级元素:
<status> 包含请求中状态代码。(非常重要)
零或多个 <result> 元素,每个元素都包含单独的一组地址解析地址信息和几何图形信息。
地址解析响应对象中的 "status" 字段包含请求的状态,并且可能包含调试信息,以帮助您追溯地址解析未正常工作的原因。
"status" 字段可能包含以下值:
"OK" 表示未发生错误;地址成功进行了解析并且至少传回了一个地址解析结果。(判断请求是否成功响应)
"ZERO_RESULTS" 表示地址解析成功,但未返回结果。如果地址解析过程中传递的偏远位置 address 或 latlng 并不存在,则会出现这种情况。
"OVER_QUERY_LIMIT" 表示您超出了配额。
"REQUEST_DENIED" 表示您的请求被拒绝,通常是由于缺少 sensor 参数。
"INVALID_REQUEST" 通常表示缺少查询参数(address 或 latlng)。
实例一:在IE浏览中输入上述实例一中的请求,查看响应结果。
浏览器中显示如下信息(该截图只是响应结果的部分信息):
实例二:通过控制台输出上述实例二的响应。
C#代码:
1 using System;
2 using SystemCollectionsGeneric;
3 using SystemLinq;
4 using SystemText;
5 using SystemNet;
6
7 namespace GeoCodeTest
8 {
9 class Program
10 {
11 static void Main(string[] args)
12 {
13 WebClient client = new WebClient();
14 string url = "ht tp:/ /mapsgo oglec om/maps/a pi/geocode/xmllatlng=39910093,116403945&language=zh-CN&sensor=false";
15 clientEncoding = EncodingUTF8;
16 string responseTest = clientDownloadString(url);
17
18 ConsoleWrite("{0}",responseTest);
19
20 ConsoleRead();
21
22 }
23 }
24 }
输出结果(该截图只是响应结果的部分信息):
5 处理响应结果
通过上述内容,我们已经能够得到xml响应信息。但是,响应结果包含很多信息,因此我们需要解析出需要的地址信息。具体实现过程为:
第一步:判断status的状态信息。
第二步:获取formatted_address 地址信息。
注意:formatted_address是一个字符串,包含此位置的人类可读地址。通常该地址相当于“邮政地址”,有时会因不同国家/地区而存在差异。
实现代码如下:
View Code
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)