在您的應用程式中使用Google 地圖API - Xamarin

以程式設計方式變更地圖的觀點。

新增和自訂標記。

標注具有重迭的地圖。

不同于現在已淘汰的Google 地圖android API v1， ... 跳到主要內容 已不再支援此瀏覽器。

請升級至MicrosoftEdge，以利用最新功能、安全性更新和技術支援。

下載MicrosoftEdge 其他資訊 目錄 結束焦點模式 閱讀英文 儲存 目錄 閱讀英文 儲存 Twitter LinkedIn Facebook 電子郵件 WeChat 目錄 在您的應用程式中使用Google地圖API 發行項 04/02/2022 8位參與者 此頁面有所助益嗎？ Yes No 還有其他意見反應嗎？ 系統會將意見反應傳送給Microsoft：按下[提交]按鈕，您的意見反應將用來改善Microsoft產品和服務。

隱私權原則。

送出 謝謝。

本文內容 使用地圖應用程式很好，但有時候您會想要在應用程式中直接包含對應。

除了內建的maps應用程式之外，Google也提供適用于Android的原生對應API。

地圖API適用于您想要更充分掌控對應體驗的案例。

地圖API可能的事項包括： 以程式設計方式變更地圖的觀點。

新增和自訂標記。

標注具有重迭的地圖。

不同于現在已淘汰的Google地圖androidAPIv1，Google地圖androidAPIv2是GooglePlayServices的一部分。

Xamarin.Android應用程式必須符合某些必要的必要條件，才能使用Google地圖AndroidAPI。

Google地圖API必要條件 您必須採取幾個步驟，才能使用地圖API，包括： 取得地圖API金鑰 安裝GooglePlayServicesSDK 安裝>xamarin.googleplayservices.base。

從NuGet地圖套件 指定必要的許可權 （選擇性）使用GoogleApi建立模擬器 取得Google地圖API金鑰 第一個步驟是取得Google地圖api金鑰(請注意，您無法重複使用舊版Google地圖v1API)中的API金鑰。

如需如何取得及使用適用于Xamarin的API金鑰的詳細資訊，請參閱取得Google地圖Api金鑰。

安裝GooglePlayServicesSDK GooglePlayServices是Google提供的技術，可讓Android應用程式利用各種Google功能，例如Google+、In-App帳單和地圖。

這些功能可在Android裝置上以背景服務的形式存取，這些裝置包含在GOOGLEPLAYSERVICESAPK中。

Android應用程式會透過GooglePlayServices用戶端程式庫與GooglePlayServices互動。

此程式庫包含個別服務（例如地圖）的介面和類別。

下圖顯示Android應用程式與GooglePlayServices之間的關聯性： Android地圖API是GooglePlayServices的一部分來提供。

在XamarinAndroid應用程式可以使用地圖API之前，必須使用AndroidSDK管理員安裝GooglePlayServicesSDK。

下列螢幕擷取畫面顯示AndroidSDK管理員可以在何處找到GooglePlayservices用戶端： 注意 GooglePlayservicesAPK是可能不會出現在所有裝置上的授權產品。

如果未安裝，Google地圖將無法在裝置上運作。

安裝>xamarin.googleplayservices.base。

從NuGet地圖套件 地圖>xamarin.googleplayservices.base套件包含適用于GooglePlayServices地圖API的Xamarin.Android系結。

若要加入GooglePlayServices對應封裝，請在方案總管中，以滑鼠右鍵按一下專案的[參考]資料夾，然後按一下[管理NuGet封裝...： 這會開啟NuGet封裝管理員。

按一下[流覽]，然後在[搜尋]欄位中輸入XamarinGooglePlayServices地圖。

地圖選取[>xamarin.googleplayservices.base]，然後按一下[安裝]。

(如果先前已安裝此套件，請按一下[更新]。

)： 請注意，也會安裝下列相依性套件： >xamarin.googleplayservices.base基底 >xamarin.googleplayservices.base >xamarin.googleplayservices.base 指定必要的許可權 應用程式必須識別硬體和許可權需求，才能使用Google地圖API。

GooglePlayServicesSDK會自動授與某些許可權，因此開發人員不需要明確地將它們新增至AndroidManfest.XML： 存取網路狀態–地圖API必須能夠檢查是否可以下載地圖底圖。

網際網路存取-必須有網際網路存取權，才能下載地圖底圖，並與GooglePlay伺服器進行通訊以進行API存取。

您必須在Google地圖AndroidAPI的AndroidManifest.XML中指定下列許可權和功能： OPENGLesv2–應用程式必須宣告OpenGLesv2的需求。

Google地圖Api金鑰–api金鑰是用來確認應用程式已註冊，且已獲授權可使用GooglePlayServices。

如需此金鑰的詳細資訊，請參閱取得Google地圖API金鑰。

要求舊版的APACHEHTTP用戶端–以Android9.0(API層級28)或以上版本為目標的應用程式，必須指定舊版ApacheHTTP用戶端是要使用的選擇性程式庫。

存取GoogleWeb服務–應用程式需要存取googleweb服務的許可權，以存取Android地圖API。

GooglePlayServices通知的許可權–應用程式必須獲得從GooglePlayServices接收遠端通知的許可權。

存取位置提供者–這些是選擇性的許可權。

它們可讓GoogleMap類別在地圖上顯示裝置的位置。

此外，Android9已從bootclasspath移除ApacheHTTP用戶端程式庫，因此以API28或更高版本為目標的應用程式無法使用該程式庫。

您必須將下列程式程式碼新增至application檔案的application節點，才能在以API28或更高版本為目標的應用程式中繼續使用ApacheHTTP用戶端： ... 注意 舊版GooglePlaySDK需要應用程式來要求WRITE_EXTERNAL_STORAGE許可權。

GooglePlayServices最近的Xamarin系結不再需要這項需求。

下列程式碼片段是必須新增至AndroidManifest.XML的設定範例： .permission.MAPS_RECEIVE"/> .permission.MAPS_RECEIVE"android:protectionLevel="signature"/> 除了要求AndroidManifest.XML許可權之外，應用程式也必須針對和ACCESS_FINE_LOCATION許可權執行執行時間許可權檢查。

如需執行執行時間許可權檢查的詳細資訊，請參閱「XamarinAndroid許可權指南」。

使用Googleapi建立Emulator 如果未安裝具有GooglePlay服務的實體Android裝置，則可以建立用於開發的模擬器映射。

如需詳細資訊，請參閱裝置管理員。

GoogleMap類別 滿足必要條件之後，就可以開始開發應用程式，並使用Android地圖API。

GoogleMap類別是Xamarinandroid應用程式將用來顯示Google地圖forandroid並與其互動的主要API。

此類別具有下列責任： 與GooglePlay服務互動，以授權應用程式使用Googleweb服務。

下載、快取及顯示地圖底圖。

將UI控制項（例如平移和縮放）顯示給使用者。

在地圖上繪製標記和幾何形狀。

GoogleMap會以下列兩種方式之一新增至活動： MapFragment-MapFragment是做為物件主機的特製化片段。

MapFragment需要ANDROIDAPI層級12或更高版本。

較舊版本的Android可以使用SupportMapFragment。

本指南將著重于使用MapFragment類別。

MapView-MapView是特製化的View子類別，可作為物件的主機。

此類別的使用者必須將所有的活動生命週期方法轉寄給MapView類別。

每個容器都會公開一個Map屬性，以傳回的實例GoogleMap。

應將喜好設定提供給MapFragment類別，因為它是較簡單的API，可減少開發人員必須手動執行的未定案程式碼數量。

將MapFragment新增至活動 下列螢幕擷取畫面是簡單MapFragment的範例： 類似于其他片段類別，有兩種方式可將加入MapFragment至活動： 以宣告方式-可透過活動的XML配置檔加入。

下列XML程式碼片段顯示如何使用fragment元素的範例： 以程式設計方式-可以使用MapFragment.NewInstance方法以程式設計方式具現化，然後再新增至活動。

此程式碼片段顯示將物件具現化MapFragment並加入至活動的最簡單方式： varmapFrag=MapFragment.NewInstance(); activity.FragmentManager.BeginTransaction() .Add(Resource.Id.map_container,mapFrag,"map_fragment") .Commit(); 您可以藉由將物件傳遞GoogleMapOptions給來NewInstance設定MapFragment物件。

這將在本指南稍後的GoogleMap屬性一節中討論。

MapFragment.GetMapAsync方法是用來初始化GoogleMap由片段裝載的，並取得所裝載之map物件MapFragment的參考。

這個方法會採用可執行介面的物件IOnMapReadyCallback。

這個介面具有單一方法，當應用程式可以與物件互動時，IMapReadyCallback.OnMapReady(MapFragmentmap)就會叫用GoogleMap此方法。

下列程式碼片段說明Android活動如何初始化MapFragment和執行IOnMapReadyCallback介面： publicclassMapWithMarkersActivity:AppCompatActivity,IOnMapReadyCallback { protectedoverridevoidOnCreate(Bundlebundle) { base.OnCreate(bundle); SetContentView(Resource.Layout.MapLayout); varmapFragment=(MapFragment)FragmentManager.FindFragmentById(Resource.Id.map); mapFragment.GetMapAsync(this); //remainderofcodeomitted } publicvoidOnMapReady(GoogleMapmap) { //Dosomethingwiththemap,i.e.addmarkers,movetoaspecificlocation,etc. } } 對應類型 Google地圖API提供五種不同類型的對應： Normal-這是預設的對應類型。

它會顯示道路和重要的自然功能，以及一些感興趣的點(例如建築物和橋接器)。

附屬-此地圖顯示衛星攝影。

混合式-此地圖顯示衛星攝影和藍圖。

地形-這主要是以一些道路來說明topographical的功能。

無：此對應不會載入任何圖格，而是會轉譯為空的方格。

下圖顯示三種不同類型的地圖，從左至右(標準、混合式地形)： GoogleMap.MapType屬性是用來設定或變更要顯示的地圖類型。

下列程式碼片段說明如何顯示附屬地圖。

publicvoidOnMapReady(GoogleMapmap) { map.MapType=GoogleMap.MapTypeHybrid; } GoogleMap屬性 GoogleMap定義數個屬性，可控制地圖的功能和外觀。

設定初始狀態的GoogleMap其中一種方式是在建立MapFragment時傳遞GoogleMap物件。

下列程式碼片段是在建立MapFragment時使用GoogleMapOptions物件的其中一個範例： GoogleMapOptionsmapOptions=newGoogleMapOptions() .InvokeMapType(GoogleMap.MapTypeSatellite) .InvokeZoomControlsEnabled(false) .InvokeCompassEnabled(true); FragmentTransactionfragTx=FragmentManager.BeginTransaction(); mapFragment=MapFragment.NewInstance(mapOptions); fragTx.Add(Resource.Id.map,mapFragment,"map"); fragTx.Commit(); 設定的另一GoogleMap種方式是在map物件的GoogleMap上操作屬性。

下一個程式碼範例顯示如何設定GoogleMap，以顯示縮放控制項和羅盤： publicvoidOnMapReady(GoogleMapmap) { map.UiSettings.ZoomControlsEnabled=true; map.UiSettings.CompassEnabled=true; } 與GoogleMap互動 Android地圖api提供可讓活動變更視點、新增標記、放置自訂覆迭或繪製幾何形狀的Api。

本節將討論如何在Xamarin中完成這些工作。

變更視點 地圖會根據Mercator投射，模型化為螢幕上的平面平面。

地圖視圖是指在此平面上直接查看的相機。

您可以藉由變更位置、縮放、傾斜和方位來控制相機的位置。

CameraUpdate類別可用來移動相機位置。

CameraUpdate物件不會直接具現化，而地圖API會提供CameraUpdate類別。

CameraUpdate一旦建立物件之後，就會將它當作參數傳遞至CameraUpdate或GoogleMap.AnimateCamera方法。

MoveCamera方法會在方法提供順暢、動畫的轉換時AnimateCamera，立即更新對應。

此程式碼片段是一個簡單的範例，說明如何使用CameraUpdateFactory建立CameraUpdate，將地圖的縮放層級遞增一個縮放層級： MapFragmentmapFrag=(MapFragment)FragmentManager.FindFragmentById(Resource.Id.my_mapfragment_container); mapFrag.GetMapAsync(this); ... publicvoidOnMapReady(GoogleMapmap) { map.MoveCamera(CameraUpdateFactory.ZoomIn()); } 地圖API提供的CameraPosition會匯總相機位置的所有可能值。

此類別的實例可提供給將會傳回物件的CameraUpdateFactory.NewCameraPosition方法。

地圖API也包含可提供流暢API來建立物件的CameraPositionBuilder類別。

下列程式碼片段顯示從CameraPosition建立的CameraUpdate範例，並使用它來變更上GoogleMap的相機位置： publicvoidOnMapReady(GoogleMapmap) { LatLnglocation=newLatLng(50.897778,3.013333); CameraPosition.Builderbuilder=CameraPosition.InvokeBuilder(); builder.Target(location); builder.Zoom(18); builder.Bearing(155); builder.Tilt(65); CameraPositioncameraPosition=builder.Build(); CameraUpdatecameraUpdate=CameraUpdateFactory.NewCameraPosition(cameraPosition); map.MoveCamera(cameraUpdate); } 在先前的程式碼片段中，地圖上的特定位置會以LatLng類別表示。

縮放層級設定為18，這是Google地圖所使用之縮放的任意量值。

「方向」是指順向北的羅盤測量。

[傾斜]屬性會控制視圖角度，並從垂直指定25度的角度。

下列螢幕擷取畫面顯示執行上述程式碼之後的GoogleMap： 在地圖上繪圖 Android地圖api提供API，可在地圖上繪製下列專案： 標記-這些是用來識別地圖上單一位置的特殊圖示。

覆迭-這是可用來識別地圖上位置或區域集合的影像。

線條、多邊形和圓形-這些都是允許活動將圖形新增至地圖的api。

標記 地圖API會提供標記類別，其會封裝地圖上單一位置的所有相關資料。

標記類別預設會使用Google地圖所提供的標準圖示。

您可以自訂標記的外觀，並回應使用者按下的動作。

新增標記 若要將標記加入至地圖，必須建立新的MarkerOptions物件，然後在實例上呼叫AddMarker方法。

這個方法會傳回標記物件。

publicvoidOnMapReady(GoogleMapmap) { MarkerOptionsmarkerOpt1=newMarkerOptions(); markerOpt1.SetPosition(newLatLng(50.379444,2.773611)); markerOpt1.SetTitle("VimyRidge"); map.AddMarker(markerOpt1); } 當使用者按標記時，標記的標題將會顯示在資訊視窗中。

下列螢幕擷取畫面顯示此標記的樣子： 自訂標記 將標記新增至地圖時，可以藉由呼叫MarkerOptions.InvokeIcon方法來自訂標記所使用的圖示。

這個方法會採用BitmapDescriptor物件，其中包含呈現圖示所需的資料。

BitmapDescriptorFactory類別提供一些helper方法來簡化的建立。

下列清單介紹其中一些方法： DefaultMarker(floatcolour)–使用預設的Google地圖標記，但變更色彩。

FromAsset(stringassetName)–使用來自[資產]資料夾中指定檔案的自訂圖示。

FromBitmap(Bitmapimage)–使用指定的點陣圖作為圖示。

FromFile(stringfileName)–從指定路徑的檔案建立自訂圖示。

FromResource(intresourceId)–從指定的資源建立自訂圖示。

下列程式碼片段顯示建立青色顏色預設標記的範例： publicvoidOnMapReady(GoogleMapmap) { MarkerOptionsmarkerOpt1=newMarkerOptions(); markerOpt1.SetPosition(newLatLng(50.379444,2.773611)); markerOpt1.SetTitle("VimyRidge"); varbmDescriptor=BitmapDescriptorFactory.DefaultMarker(BitmapDescriptorFactory.HueCyan); markerOpt1.InvokeIcon(bmDescriptor); map.AddMarker(markerOpt1); } 資訊視窗 [資訊]視窗是特殊的視窗，可在使用者按一下特定標記時，向使用者顯示資訊。

[資訊]視窗預設會顯示標記標題的內容。

如果尚未指派標題，則不會顯示任何資訊視窗。

一次只會顯示一個資訊視窗。

您可以藉由執行GoogleMap.IInfoWindowAdapter介面來自訂資訊視窗。

這個介面有兩個重要的方法： publicViewGetInfoWindow(Markermarker)–呼叫此方法以取得標記的自訂資訊視窗。

null如果傳回，則會使用預設視窗轉譯。

如果這個方法傳回視圖，則該視圖會放置在資訊視窗框架內。

publicViewGetInfoContents(Markermarker)–只有在GetInfoWindownull傳回時，才會呼叫這個方法。

如果要使用資訊視窗內容的預設轉譯，則這個方法會null傳回值。

否則，此方法應該會傳回包含資訊視窗內容的視圖。

資訊視窗不是即時視圖，而是Android會將視圖轉換成靜態點陣圖，並顯示在影像上。

這表示資訊視窗無法回應任何觸控事件或手勢，也不會自動自行更新。

若要更新資訊視窗，必須呼叫GoogleMap.ShowInfoWindow方法。

下圖顯示一些自訂資訊視窗的一些範例。

左邊的影像會自訂其內容，而右邊的影像會以圓角自訂其視窗和內容： GroundOverlays 不同于在地圖上識別特定位置的標記，GroundOverlay是用來識別位置集合或地圖上某個區域的影像。

新增GroundOverlay 將地面重迭新增至地圖類似于將標記新增至地圖。

首先，會建立GroundOverlayOptions物件。

然後，這個物件會以參數的形式傳遞給方法，GroundOverlay以GoogleMap.AddGroundOverlay傳回物件。

此程式碼片段是將地面重迭新增至地圖的範例： BitmapDescriptorimage=BitmapDescriptorFactory.FromResource(Resource.Drawable.polarbear); GroundOverlayOptionsgroundOverlayOptions=newGroundOverlayOptions() .Position(position,150,200) .InvokeImage(image); GroundOverlaymyOverlay=googleMap.AddGroundOverlay(groundOverlayOptions); 下列螢幕擷取畫面顯示地圖上的這項覆蓋： 線條、圓形和多邊形 有三種可新增至地圖的簡單類型幾何圖： 聚合線條-這是一連串連接的線段。

它可以標示地圖上的路徑，或建立幾何形狀。

圓形-這會在地圖上繪製圓形。

多邊形-這是標示地圖上區域的封閉圖形。

折線 聚合線條是連續物件的清單，可指定每個線段的頂點。

建立聚合線條的方式是先建立PolylineOptions物件，並在其中加入點。

PolylineOption然後藉由呼叫AddPolyline方法，將物件傳遞給GoogleMap物件。

PolylineOptionrectOptions=newPolylineOption(); rectOptions.Add(newLatLng(37.35,-122.0)); rectOptions.Add(newLatLng(37.45,-122.0)); rectOptions.Add(newLatLng(37.45,-122.2)); rectOptions.Add(newLatLng(37.35,-122.2)); rectOptions.Add(newLatLng(37.35,-122.0));//closethepolyline-thismakesarectangle. googleMap.AddPolyline(rectOptions); 圓形 圓形的建立方式是先具現化CircleOption物件，此物件將會指定metres中圓形的中心和半徑。

藉由呼叫GoogleMapAddCircle，在地圖上繪製圓形。

下列程式碼片段顯示如何繪製圓形： CircleOptionscircleOptions=newCircleOptions(); circleOptions.InvokeCenter(newLatLng(37.4,-122.1)); circleOptions.InvokeRadius(1000); googleMap.AddCircle(circleOptions); 多邊形 Polygon與s類似Polyline，不過它們並未開啟。

Polygons是封閉的迴圈，其內部已填滿。

Polygon會以與相同的相同方式來建立，但所叫Polyline用的Polygon方法除外。

不同于Polyline，Polygon會自行關閉。

藉由繪製連接第一個和最後一個點的線條，方法會關閉AddPolygon多邊形。

下列程式碼片段會在與範例中Polyline先前的程式碼片段相同的區域上建立一個實心矩形。

PolygonOptionsrectOptions=newPolygonOptions(); rectOptions.Add(newLatLng(37.35,-122.0)); rectOptions.Add(newLatLng(37.45,-122.0)); rectOptions.Add(newLatLng(37.45,-122.2)); rectOptions.Add(newLatLng(37.35,-122.2)); //noticewedon'tneedtocloseoffthepolygon googleMap.AddPolygon(rectOptions); 回應使用者事件 有三種類型的互動：使用者可能具有地圖： 標記按一下-使用者按一下標記。

標記拖曳-使用者長按mparger 資訊視窗點擊-使用者已按一下資訊視窗。

以下將更詳細地討論每個事件。

標記點擊事件 MarkerClicked當使用者按了標記時，就會引發事件。

此事件會接受GoogleMap.MarkerClickEventArgs物件做為參數。

此類別包含兩個屬性： GoogleMap.MarkerClickEventArgs.Handled–這個屬性應該設定為true，表示事件處理常式已取用事件。

如果設定為，false則除了事件處理常式的自訂行為之外，也會發生預設行為。

Marker–這個屬性是引發MarkerClick事件之標記的參考。

此程式碼片段顯示的範例MarkerClick會將相機位置變更為地圖上的新位置： voidMapOnMarkerClick(objectsender,GoogleMap.MarkerClickEventArgsmarkerClickEventArgs) { markerClickEventArgs.Handled=true; varmarker=markerClickEventArgs.Marker; if(marker.Id.Equals(gotMauiMarkerId)) { LatLngInMaui=newLatLng(20.72110,-156.44776); //MovethecameratolookatMaui. PositionPolarBearGroundOverlay(InMaui); googleMap.AnimateCamera(CameraUpdateFactory.NewLatLngZoom(InMaui,13)); gotMauiMarkerId=null; polarBearMarker.Remove(); polarBearMarker=null; } else { Toast.MakeText(this,$"YouclickedonMarkerID{marker.Id}",ToastLength.Short).Show(); } } 標記拖曳事件 當使用者希望拖曳標記時，會引發此事件。

根據預設，標記無法拖曳。

您可以藉由將屬性設定Marker.Draggable為，true或藉由MarkerOptions.Draggable以參數的方式叫用方法，true將標記設定為可拖曳。

若要拖曳標記，使用者必須先在標記上按一下滑鼠右鍵，然後其手指必須留在地圖上。

當使用者的手指在螢幕上拖曳時，標記就會移動。

當使用者的手指離開螢幕時，標記就會保留在原處。

下列清單說明可拖曳標記將引發的各種事件： GoogleMap.MarkerDragStart(objectsender,GoogleMap.MarkerDragStartEventArgse)–當使用者第一次拖曳標記時，就會引發此事件。

GoogleMap.MarkerDrag(objectsender,GoogleMap.MarkerDragEventArgse)–當正在拖曳標記時，會引發此事件。

GoogleMap.MarkerDragEnd(objectsender,GoogleMap.MarkerDragEndEventArgse)–當使用者完成拖曳標記時，就會引發此事件。

EventArgs每一個都包含名P0為的單一屬性，它是要Marker拖曳之物件的參考。

資訊視窗點擊事件 一次只能顯示一個資訊視窗。

當使用者按一下地圖中的[資訊]視窗時，地圖物件將會引發InfoWindowClick事件。

下列程式碼片段顯示如何將處理常式連接到事件： publicvoidOnMapReady(GoogleMapmap) { map.InfoWindowClick+=MapOnInfoWindowClick; } privatevoidMapOnInfoWindowClick(objectsender,GoogleMap.InfoWindowClickEventArgse) { MarkermyMarker=e.Marker; //Dosomethingwithmarker. } 回想一下，資訊視窗是在地圖上呈現為影像的靜態View。

任何widget（例如按鈕、核取方塊或放在資訊視窗內的文字流覽）都會惰性，而且無法回應其任何整數的使用者事件。

相關連結 SimpleMapDemo GooglePlay服務 Google地圖AndroidAPIv2 GooglePlayServicesAPK 取得Google地圖API金鑰 使用程式庫 使用-功能 本文內容