摘要

Google Maps API Web Services，是一個為您的地圖應用程序提供地理數據的 Google 服務的 HTTP 接口集合。具體包括：Google Geocoding API、Google Directions API、Google Elevation API、Google Places API。本文將探討如何通過Google Geocoding API服務來獲取地址信息。

---

目錄

什么是網絡服務？
區分地址解析與反地址解析
地址查詢（反地址解析）請求
地址查詢（反地址解析）響應
處理響應結果

---

1. 什么是網絡服務？

Google Maps API 提供這些網絡服務作為從外部服務中請求 Google Maps API 數據以及在您的地圖應用程序中使用它們的接口。這些網絡服務使用特定網址的 HTTP 請求并將網址參數作為參數提供給服務。一般來講，這些服務會在 HTTP 請求中以 JSON 或 XML 的形式傳回數據，供您的應用程序進行解析和/或處理。

一個典型的網絡服務請求通常采用以下形式：

http://maps.google.com/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 請求必須采用以下形式：

http://maps.google.com/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）。

http://maps.google.com/maps/api/geocode/xml?latlng=39.910093,116.403945&language=zh-CN&sensor=false

注意：經緯度書寫的順序為（緯度，經度）。

實例二：利用C#在客戶端程序中創建上述請求。

1 WebClient client = new WebClient();
2 string url = "http://maps.google.com/maps/api/geocode/xml?latlng=39.910093,116.403945&language=zh-CN&sensor=false";
3 client.Encoding = Encoding.UTF8;
4 string responseTest = client.DownloadString(url);

4. 地址查詢（反向地址解析）響應

地址解析響應將以網址請求路徑中的 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 = "http://maps.google.com/maps/api/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

 1 using System;
 2 using System.Collections.Generic;
 3 using System.Linq;
 4 using System.Text;
 5 using System.Net;
 6 using System.Xml;
 7 
 8 namespace GeoCodeTest
 9 {
10     class Program
11     {
12         static void Main(string[] args)
13         {
14             WebClient client = new WebClient();//webclient客戶端對象
15             string url = "http://maps.google.com/maps/api/geocode/xml?latlng=39.910093,116.403945&language=zh-CN&sensor=false";//請求地址
16             client.Encoding = Encoding.UTF8;//編碼格式
17             string responseTest = client.DownloadString(url);//下載xml響應數據
18 
19             XmlDocument doc = new XmlDocument();//創建XML文檔對象
20 
21             if(!string.IsNullOrEmpty(responseTest))
22             {
23               doc.LoadXml(responseTest);//加載xml字符串
24 
25 //獲取狀態信息
26               string xpath = @"GeocodeResponse/status";
27               XmlNode node = doc.SelectSingleNode(xpath);
28               string status = node.InnerText.ToString();
29               
30               if(status == "OK")
31               {
32                   //獲取地址信息
33                   xpath = @"GeocodeResponse/result/formatted_address";
34                   node = doc.SelectSingleNode(xpath);
35                   string address = node.InnerText.ToString();
36 
37                   Console.WriteLine("地址：{0}",address);//輸出地址信息
38               }
39               
40             }
41             
42 
43             Console.Read();
44 
45         }
46     }
47 }

輸出結果：

我叫劉皓，很高興您能閱讀完我的這篇文章。
我花了大量時間和精力來完成這篇文章，如果文章對您有幫助，請不要忘了點推薦哦！
如果您能點擊右邊的打賞按鈕，打賞一杯咖啡錢，我將獲得更多的動力和能量寫出下一篇好文章。

本文版權歸作者和博客園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文鏈接，否則保留追究法律責任的權利。
我的博客即將搬運同步至騰訊云+社區，邀請大家一同入駐：https://cloud.tencent.com/developer/support-plan

總結

以上是生活随笔為你收集整理的如何通过经纬度获取地址信息？的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。