http://code.google.com/intl/zh-CN/apis/maps/documentation/geocoding/#Types
地址组成部分的类型
返回结果中的 types[] 数组表示地址类型。 address_components[] 数组中也可能返回这些类型，以表示特定地址组成部分的类型。地址解析器中的地址可能有多种类型，这些类型也可以视为“标签”。例如，许多城市都带有 political 和 locality 类型的标签。
HTTP 地址解析器支持并返回以下类型：
street_address表示一个精确的街道地址。route表示一条已命名的路线（如“US 101”）。intersection表示一个大十字路口，通常由两条主道交叉形成。political表示一个政治实体。此类型通常表示代表某个行政管理区的多边形。country表示国家政治实体。在地址解析器返回的结果中，该部分通常列在最前面。administrative_area_level_1表示仅次于国家级别的行政实体。在美国，这类行政实体是指州。并非所有国家都有该行政级别。administrative_area_level_2表示国家级别下的二级行政实体。在美国，这类行政实体是指县。并非所有国家都有该行政级别。administrative_area_level_3表示国家级别下的三级行政实体。此类型表示较小的行政单位。并非所有国家都有该行政级别。colloquial_area表示实体的通用别名。locality表示合并的市镇级别政治实体。sublocality表示仅次于地区级别的行政实体。neighborhood表示已命名的邻近地区。premise表示已命名的位置，通常是具有常用名称的建筑物或建筑群。subpremise表示仅次于已命名位置级别的实体，通常是使用常用名称的建筑群中的某座建筑物。postal_code表示邮政编码，用于确定相应国家/地区内的信件投递地址。natural_feature表示某个明显的自然特征。airport表示机场。park表示已命名的公园。point_of_interest表示已命名的兴趣点。通常，这些“POI”是一些不易归入其他类别的比较有名的当地实体，如“帝国大厦”或“自由女神像”。
除此之外，地址组成部分还可以使用以下类型：
post_box表示一个具体的邮筒。street_number表示精确的街道编号。floor表示建筑物的楼层号。room表示建筑物的房间编号。
反向地址解析（地址查询）
术语“地址解析”通常是指将人类可读的地址转换成地图上的位置。 反之，将地图上的位置转换成人类可读的地址这一过程则称为“反向地址解析”。
Google Geocoding API 支持直接使用 latlng 参数进行反向地址解析。例如，下列查询包含了布鲁克林某一位置的纬度/经度值：
http://maps.google.com/maps/api/geocode/json?latlng=40.714224,-73.961452&sensor=true_or_false
请注意：在传入 latlng 参数时，请确保纬度值与经度值之间没有空格。
该查询返回下列结果：
{
"status": "OK",
"results": [ {
"types": [ "street_address" ],
"formatted_address": "275-291 Bedford Ave, Brooklyn, NY 11211, USA",
"address_components": [ {
"long_name": "275-291",
"short_name": "275-291",
"types": [ "street_number" ]
}, {
"long_name": "Bedford Ave",
"short_name": "Bedford Ave",
"types": [ "route" ]
}, {
"long_name": "New York",
"short_name": "New York",
"types": [ "locality", "political" ]
}, {
"long_name": "Brooklyn",
"short_name": "Brooklyn",
"types": [ "administrative_area_level_3", "political" ]
}, {
"long_name": "Kings",
"short_name": "Kings",
"types": [ "administrative_area_level_2", "political" ]
}, {
"long_name": "New York",
"short_name": "NY",
"types": [ "administrative_area_level_1", "political" ]
}, {
"long_name": "United States",
"short_name": "US",
"types": [ "country", "political" ]
}, {
"long_name": "11211",
"short_name": "11211",
"types": [ "postal_code" ]
} ],
"geometry": {
"location": {
"lat": 40.7142298,
"lng": -73.9614669
},
"location_type": "RANGE_INTERPOLATED",
"viewport": {
"southwest": {
"lat": 40.7110822,
"lng": -73.9646145
},
"northeast": {
"lat": 40.7173774,
"lng": -73.9583193
}
}
}
},
... Additionalresults[]...
请注意，反向地址解析器传回了多个结果。结果的 "formatted_addresses" 不仅是指通信地址，还包含对位置进行地理命名的所有方式。例如，当对芝加哥市中的一个点进行地址解析时，地址解析的点可标注为其街道地址、城市（芝加 哥）、州（伊利诺斯）或国家（美国）。这些对地址解析器来说都是“地址”。反向地址解析器可将任何这些类型的地址作为有效结果传回。
反向地址解析器将匹配政治实体（国家/地区、省、市和邻近地区）、街道地址和邮政编码。
前一查询所传回的 formatted_address 值的完整列表如下所示。
"formatted_address": "275-291 Bedford Ave, Brooklyn, NY 11211, USA",
"formatted_address": "Williamsburg, NY, USA",
"formatted_address": "New York 11211, USA",
"formatted_address": "Kings, New York, USA",
"formatted_address": "Brooklyn, NY, USA",
"formatted_address": "New York, NY, USA",
"formatted_address": "New York, USA",
"formatted_address": "United States"
通常，地址将按照具体程度由高到低的顺序传回；最确切的地址将作为最显著的结果传回，本例就是如此。请注意，我们传回了各种不同的地址，从十分具体的街道地址到比较笼统的政治实体，如邻近地区、市、县、州/省等。如果您希望匹配更广泛的地址，可能要检查传回的 Placemark 的 "types" 字段（请参见上文的地址组成部分类型）。
注意：反向地址解析给出的是估计结果。地址解析器会试图在一定的偏差范围内查找最接近的可寻址位置；如果找不到匹配项，地址解析器通常不会传回结果。
https://github.com/alexreisner/geocoder/blob/master/CHANGELOG.rdoc
0.9.9 (2011 Mar 9)
https://github.com/alexreisner/geocoder/blob/master/CHANGELOG.rdoc
Add support for IP address geocoding via FreeGeoIp.net.
Add support for Yahoo PlaceFinder geocoding API.
Add support for custom geocoder data handling by passing a block to geocoded_by or reverse_geocoded_by.
Add Rack::Request#location method for geocoding user’s IP address.
Change gem name to geocoder (no more rails-geocoder).
Gem now works outside of Rails.
DEPRECATION: fetch_coordinates no longer takes an argument.
