Google 地理编码网络服务 (JSON 响应)

Google 地理编码网络服务是一项由谷歌提供的服务，旨在将地址转换为经纬度坐标并提供有关此位置的其他信息，如国家、州、城市、邮政编码等。该服务返回 JSON 格式的响应，使程序员能够轻松解析和处理返回的数据。

服务 URL

该服务的 URL 如下所示：

https://maps.googleapis.com/maps/api/geocode/json?parameters

其中，“parameters”是指各种可用于定义请求的参数，如地址、语言、结果类型等。

请求参数

以下是一些可用于 Google 地理编码网络服务请求的参数：

• address：要编码的地址。可以是标准地址、地标或名称。
• components：通过名称-值对的方式过滤查询结果，例如“country: GB”。
• bounds：要限制搜索结果的边界框。
• language：响应的语言。
• region：应使用哪个地理区域（ccTLD）来执行地址解析。

响应格式

响应是以 JSON 格式返回的。以下是响应对象的一些常见属性：

• results：一个对象数组，每个对象描述一个地址（匹配地址、类型、边界框等）。
• formatted_address：解析出的地址字符串。
• location：一个对象，描述地址的地理位置。
• address_components：一个包含有关地址组成部分（路、城市、州等）的对象数组。

示例

下面是一个典型的 Google 地理编码网络服务请求：

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

其中，“key”是您的 API 密钥，用于限制服务的使用。以下是响应示例的一些片段：

{
   "results" : [
      {
         "address_components" : [
            {
               "long_name" : "1600",
               "short_name" : "1600",
               "types" : [ "street_number" ]
            },
            {
               "long_name" : "Amphitheatre Parkway",
               "short_name" : "Amphitheatre Pkwy",
               "types" : [ "route" ]
            },
            {
               "long_name" : "Mountain View",
               "short_name" : "Mountain View",
               "types" : [ "locality", "political" ]
            },
            {
               "long_name" : "Santa Clara County",
               "short_name" : "Santa Clara County",
               "types" : [ "administrative_area_level_2", "political" ]
            },
            {
               "long_name" : "California",
               "short_name" : "CA",
               "types" : [ "administrative_area_level_1", "political" ]
            },
            {
               "long_name" : "United States",
               "short_name" : "US",
               "types" : [ "country", "political" ]
            },
            {
               "long_name" : "94043",
               "short_name" : "94043",
               "types" : [ "postal_code" ]
            }
         ],
         "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
         "geometry" : {
            "location" : {
               "lat" : 37.4224764,
               "lng" : -122.0842499
            }
         },
         "types" : [ "street_address" ]
      }
   ],
   "status" : "OK"
}

结论

Google 地理编码网络服务为许多应用程序和服务提供了强大的地址解析和地理编码功能。使用该服务，程序员可以轻松地将地址转换为坐标，并在需要时进行逆地理编码。