GoogleApi

GoogleAPI

無縫 Google Api 整合。
Google 地圖、地點、道路、搜尋和翻譯。

請隨意貢獻、提出問題和回報問題。我通常回覆速度很快（24-48 小時）。
您需要額外的 .Net 框架支援嗎？

新增內容：版本 5.0.0 包含路線 Api（方向和矩陣）、Ariel View Api 和位址驗證 Api。

---

使用圖書館

可以透過使用單獨的 Facede 實作或透過相依性注入單獨的 api 來使用該函式庫。
每個 api 實作都包含一個請求和一個回應。請求具有反映支援的參數的屬性，回應表示傳回的 json 的物件模型。

其他一些值得注意的成員。

 var uri = request . GetUri ( ) ; // Gets the full request uri, including query parameters.
var params = request . GetQUeryStringParameters ( ) ; // Gets a list of all the added parameters. 

response . RawJson // The raw json returned by Google.
response . RawQueryString // The querystring sent to Google when invoking the request. 

正面

每個 api 都有一個通用的外觀操作來執行請求並回傳回應。
下面的範例僅填入請求、呼叫外觀操作並接收傳回的回應。

 TRequest request = new TRequest ( ) ;
TResponse response = await { Api } . [ { SubGroup } ] . { Action } . QueryAsync < TRequest , TResponse > ( request ) ;

請參閱下文，了解支援的 Api 和操作的完整清單。

依賴注入

如果首選將 api 作為依賴項注入，請在啟動期間註冊服務，如下所示。

services
    . AddGoogleApiClients ( ) ;

然後，根據需要將各個 Api 注入建構函式中

 public class MyClass
{
    private Api api ;
    
    public MyClass ( Api api )
    {
        this . api = api
    }
}

請參閱下文，了解支援的 Api 和操作的完整清單。

代理人

如果需要WebProxy ，請在註冊 GoogleApi 依賴項或使用 Facade 之前設定靜態屬性HttpClientFactory.Proxy 。

---

支援的 Api

支持以下 api。

Google地圖

• 路線（ GoogleMaps.Directions ）
• 距離矩陣（ GoogleMaps.DistanceMatrix ）
• 海拔（ GoogleMaps.Elevation ）
• 地理編碼
  • 地點（ GoogleMaps.Geocode.PlaceGeocode ）
  • 地址（ GoogleMaps.Geocode.AddressGeocode ）
  • 位置（反向）（ GoogleMaps.Geocode.LocationGeocode ）
  • 加號（ GoogleMaps.Geocode.PlusCodeGeocode ）
• 地理定位（ GoogleMaps.Geolocation ）
• 道路
  • 最近的道路（ GoogleMaps.Roads.NearestRoads ）
  • 對齊道路 ( GoogleMaps.Roads.SnapToRoad )
  • 速度限制 ( GoogleMaps.Roads.SpeedLimits )
• 時區
• 街景
• 靜態地圖
• 路線
  • 路線方向（ GoogleMaps.Routes.Directions ）
  • 路線矩陣（ GoogleMaps.Routes.Matrix ）
• 地址驗證（ GoogleMaps.AddressValidation ）
• 鳥瞰圖（測試版）
  • 取得影片 ( GoogleMaps.AerialView.GetVideo )
  • 渲染影片 ( GoogleMaps.AerialView.RenderVideo )

谷歌地方資訊

• 地點搜尋
  • 尋找 ( GooglePlaces.Search.FindSearch )
  • 附近 ( GooglePlaces.Search.NearBySearch )
  • 文字（ GooglePlaces.Search.TextSearch ）
• 地點詳細資料 ( GooglePlaces.Details )
• 地點照片 ( GooglePlaces.Photos )
• 地點自動完成 ( GooglePlaces.AutoComplete )
• 查詢自動完成（ GooglePlaces.QueryAutoComplete ）

谷歌搜尋

• 網路 ( GoogleSearch.WebSearch )
• 圖片（ GoogleSearch.ImageSearch ）
• 影片
  • 頻道（ GoogleSearch.VideoSearch.Channels ）
  • 播放清單（ GoogleSearch.VideoSearch.Playlists ）
  • 影片 ( GoogleSearch.VideoSearch.Vidoes )

Google翻譯

• 檢測（ GoogleTranslate.Detect ）
• 語言（ GoogleTranslate.Languages ）
• 翻譯（ GoogleTranslate.Translate ）

Google功能

• 合併多段線
• 編碼多段線
• 解碼多段線

---

運行測試套件

運行測試套件很簡單。

測試項目將與您的 Google 訂閱（免費或付費）相關的設定儲存在application.default.json中。
最重要的是ApiKey ，用於識別 Google 訂閱。

{ 
  "ApiKey" : " " ,
  "SearchEngineId" : " " ,
}

有關生成密鑰的更多資訊可以在這裡找到：https://console.developers.google.com/

---