如何通过经纬度获取地址信息
1. 什么是网络服务?
Google Maps API 提供这些网络服务作为从外部服务中请求 Google Maps API 数据以及在您的地图应用程序中使用它们的接口。这些网络服务使用特定网址的 HTTP 请求并将网址参数作为参数提供给服务。一般来讲,这些服务会在 HTTP 请求中以 JSON 或 XML 的形式传回数据,供您的应用程序进行解析和/或处理。
一个典型的网络服务请求通常采用以下形式:
htt p:/ /maps.g oogl e.co m/maps/api/service/output?parameters
其中 service 表示所请求的特定服务,output 表示响应格式(通常为 json 或 xml)。
2.地址解析与反地址解析
地址解析是将地址(如“1600 Amphitheatre Parkway, Mountain View, CA”)转换为地理坐标(如纬度 37.423021 和经度 -122.083739)的过程,您可以根据转换得到的坐标放置标记或定位地图。Google Geocoding API 可让您通过 HTTP 请求直接访问地址解析器。此外,该服务还可让您执行反向操作(将坐标转换为地址),此过程称为“反向地址解析”(地址查询)。
3. 地址查询(反向地址解析)请求
Google Geocoding API 请求必须采用以下形式:
htt p:/ /maps.g oogl e.c om/maps/api/geocode/output?parameters
其中,output 可以是以下值之一:
json(建议)表示以 JavaScript 对象表示法 (JSON) 的形式输出
xml 表示以 XML 的形式输出
有些参数是必需的,有些是可选的。根据网址的标准,所有参数均使用字符 & (&) 分隔。下面枚举了这些参数及其可能的值。
Google Geocoding API 使用以下网址参数定义地址查询请求:
latlng(必需)- 您希望获取的、距离最近的、可人工读取地址的纬度/经度文本值。
bounds(可选)- 要在其中更显著地偏移地址解析结果的可视区域的边框。
region(可选)- 区域代码,指定为 ccTLD(“顶级域”)双字符值。
language(可选)- 传回结果时所使用的语言。请注意,我们会经常更新支持的语言,因此该列表可能并不详尽。如果未提供 language,地址解析器将尝试尽可能使用发送请求的区域的本地语言。
sensor(必需)- 指示地址解析请求是否来自装有位置传感器的设备。该值必须为 true 或 false。
注意:bounds 和 region 参数只会影响地址解析器返回的结果,但不能对其进行完全限制。
实例一:创建查询坐标(39.910093,116.403945)的地址信息的请求,要求以xml格式输出响应,语言为简体中文(zh-CN)。
注意:经纬度书写的顺序为(纬度,经度)。
实例二:利用C#在客户端程序中创建上述请求。
1 WebClient client = new WebClient();
2 string url = "htt p:/ /m aps.g oogl e.co m/maps/api/geocode/xm l?latln g=39.910 093,116.403945&language=zh-CN&sensor=false";
3 client.Encoding = Encoding.UTF8;
4 string responseTest = client.DownloadString(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 System.Collections.Generic;
3 using System.Linq;
4 using System.Text;
5 using System.Net;
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:/ /maps.go ogle.c om/maps/a pi/geocode/xml?latlng=39.910093,116.403945&language=zh-CN&sensor=false";
15 client.Encoding = Encoding.UTF8;
16 string responseTest = client.DownloadString(url);
17
18 Console.Write("{0}",responseTest);
19
20 Console.Read();
21
22 }
23 }
24 }
输出结果(该截图只是响应结果的部分信息):
5. 处理响应结果
通过上述内容,我们已经能够得到xml响应信息。但是,响应结果包含很多信息,因此我们需要解析出需要的地址信息。具体实现过程为:
第一步:判断status的状态信息。
第二步:获取formatted_address 地址信息。
注意:formatted_address是一个字符串,包含此位置的人类可读地址。通常该地址相当于“邮政地址”,有时会因不同国家/地区而存在差异。
实现代码如下:
View Code