谷歌地图地理解析和反解析geocode.geocoder详解(转)

谷歌地图地理解析和反解析geocode.geocoder详解谷歌Geocoder服务实例代码

地址解析就是将地址(如：贵州省贵阳市)转换为地理坐标(如经度：106.71，纬度：26.57)的过程。

地理反解析和上面的过程相反是将地理坐标(如纬度：26.57，经度：106.71)转换为地址(中国贵州省贵阳市南明区翠微巷7号邮政编码: 550002)的过程。

受当地法律限制及各方面原因，国内很多地图并不包含地理解析和反解析功能（地理解析和反解析功能功能不够强悍），Google永远是最棒的。

要使用到Google map 地理解析和反解析功能，我们需要了解google.maps.Geocoder类，谷歌地图给我们提供了强大的api

下面我们来实现

1.初始化地图(最基本的，不解释)

//初始化地图
var map = new google.maps.Map(document.getElementById("map_canvas"),{
center : new google.maps.LatLng(26.57, 106.72),
zoom : 8,
mapTypeId : google.maps.MapTypeId.ROADMAP
});

2.实例化谷歌Geocoder服务

//实例化Geocoder服务
var geocoder = new google.maps.Geocoder();

这样我们就可以进行地理解析和反解析了，使用代码：

geocoder.geocode(request:GeocoderRequest, callback:function(Array., GeocoderStatus))

一请求数据：其中需要进行请求的数据GeocoderRequest可为4种属性：

属性	类型	描述
`address`	`string`	需要解析的地名. 可选.
`bounds`	`LatLngBounds`	经纬度搜索范围. 可选.（我没有具体试用过）
`location`	`LatLng（注意类型）`	需要解析的经纬度. 可选.
`region`	`string`	国家代码. 可选.（我没有具体试用过）

对于解析我们使用address，反解析使用location(注意传入的类型)，请求的话，至少选择一种。

二结果处理：而对于回掉函数（即解析后返回的处理函数）包含两个内容，GeocoderResult（解析结果，数组类型）和GeocoderStatus（解析状态）

1.解析状态是使用Geocoder()进行解析后返回的状态，包含5种：

ERROR（谷歌地图服务可能出错）
INVALID_REQUEST（GeocoderRequest无效，即输入的请求是错误的，可能是没有选择，或者属性写错）
OK（解析完成，并有相应数据）
OVER_QUERY_LIMIT（响应超时）
REQUEST_DENIED（网页被禁止geocoder解析）
UNKNOWN_ERROR（未知错误）
ZERO_RESULTS（零结果）

我们能用的就是状态为OK的情况

2.解析结果

属性	类型	描述
`address_components`	`Array.<GeocoderAddressComponent>`	`GeocoderAddressComponent`s数组
`formatted_address`	`string`	格式化后的最佳匹配地址（地名可小到街道）
`geometry`	`GeocoderGeometry`	`GeocoderGeometry` 对象
`types`	`Array.`	一个表示返回的地理编码元素的类型的字符串数组

其中每一次解析成功后都会有上面的信息，我们最需要的就两样formatted_address和geometry。而address_components是一个地名数组，包含long_name（比如只返回省市名称），short_name和types，可以自己去试一下。

(a). 格式化后的地名formatted_address，只需直接调用即可

(b).geometry返回一个GeocoderGeometry 对象，其中又包含有4个属性

Properties	Type	Description
`bounds`	`LatLngBounds`	解析出来的精确的界限
`location`	`LatLng`	纬度/经度坐标
`location_type`	`GeocoderLocationType`	返回的`location类型`
`viewport`	`LatLngBounds`	解析结果的视图范围

至此，所有关于地理解析和反解析就差不多说明完了，具体api参见https://developers.google.com/maps/documentation/javascript/reference#Geocoder。

感觉说的好晕！基于此我做了一个关于批量解析和反解析的应用，详见：http://map.yanue.net/geo.html，http://map.yanue.net/toLatLng .使用详解：http://www.yanue.net/archives/207.html

下面我们来实例一下实例代码：

（你有必要复制到本地试一下）

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<script src="http://maps.google.com/maps/api/js?sensor=false&libraries=places" type="text/javascript"></script>
<title>谷歌地图地理解析和反解析geocode.geocoder详解</title>
<meta name="author" content="yanue" />
<meta name="copyright" content="powered by yanue" />
<link rel="site" href="http://map.yanue.net/" />
<script type="text/javascript">
window.onload = function() {
//初始化地图
var map = new google.maps.Map(document.getElementById("map_canvas"),{
center : new google.maps.LatLng(26.57, 106.72),
zoom : 8,
mapTypeId : google.maps.MapTypeId.ROADMAP
});
//实例化Geocoder服务
var geocoder = new google.maps.Geocoder();
//1.地理解析过程
//请求数据GeocoderRequest为address，值为'贵阳'
geocoder.geocode({address:'贵阳'},function geoResults(results, status){
//这里是回掉函数(即结果处理函数)
//状态为Ok说明有结果
if (status == google.maps.GeocoderStatus.OK) {
//一般情况下会有多个结果
//第一个结果为最佳匹配的结果（匹配地名最全的结果），这里只去第一个，其他的可以根据需要自己循环出来
//格式化过后的地址
alert('地理解析结果：'+results[0].formatted_address);
//geometry是一个包含bounds（界限），location（纬度/经度坐标）,location_type和viewport（视图范围）
//获取解析后的经纬度
alert('地理解析结果：'+results[0].geometry.location);
}else{
alert("：error " + status);
}
});
//2.地理反解析过程
//请求数据GeocoderRequest为location，值类型为LatLng因此我们要实例化经纬度
geocoder.geocode({location:new google.maps.LatLng(26.57, 106.72)},function geoResults(results, status){
//这里处理结果和上面一模一样
if (status == google.maps.GeocoderStatus.OK) {
alert('地理反解析结果：'+results[0].formatted_address);
alert('地理反解析结果：'+results[0].geometry.location);
}else{
alert("：error " + status);
}
});
}
</script>
</head>
<body>
<div id="map_canvas" style='width: 300px; height: 200px;'></div>
</body>
</html>