在地圖上顯示你的位置

       許多iOS裝置如iPod touch、iPad和iPhone提供了裝置的位置資訊。我們知道iOS包含了一個大家都很熟悉的CoreLocation框架，該框架為我們提供了位置獲取的功能，無論是通過Wi-Fi、蜂窩網路還是GPS。這個框架同時也為開發人員提供了API，使得他們能夠將定位功能整合到他們的應用程式中去。

       AGSmapView元件提供了一個簡單的方法來顯示和追蹤裝置的位置資訊。與地圖相關聯的AGSlocationDisplay物件提供了CoreLocation框架的門戶，從而使得利用位置服務進行工作變得更加容易。

       開啟顯示位置功能

       對於早期的作業系統如iOS7或是早期版本，在地圖上展示裝置的位置資訊的話，在地圖已經完成載入後，只用呼叫AGSLocationDisplay物件的startDataSource方法即可。

-(void) mapViewDidLoad:(AGSMapView*)mapView {
 	[self.mapView.locationDisplay startDataSource];
}

       從iOS8之後，apps必須明確的請求授權來訪問裝置的位置服務。這裡有兩種授權方式可用：whenInuse 和Always取決於app是否只想在前景訪問位置，或是前景和背景都想訪問。在預設情況下，地圖請求WhenInUse授權。你需要在你app的info.plist檔案中新增NSLocationWhenInUseUsageDescription關鍵字以及對應的值。

      

       在預設情況下，地圖使用藍色、圓形符號來展示你的裝置位置。地圖總是試圖獲取最準確的位置，但是這取決與訊號的強度、衛星的位置和其它因素，而且地圖報告的位置可能只是真實位置的近似。地圖通常會用一個圍繞位置的圓圈來指示定位的精度範圍。

       位置資料來源

       AGSLocationDisplay 僅僅管理地圖上位置資訊的顯示，它並不主動去檢索任何位置資訊。相反，它依賴位置的資料來源來提供頻繁的位置更新。你可以使用它提供的任何資料來源，或者你可以插入你自己的資料來源來滿足地圖的位置更新。

       AGSLocationDisplay在沒有任何提供的情況下，預設為AGSCLLocationManangerLocationDisplayDataSource。

       AGSCLLocationManangerLocationDisplayDataSource

       該資料來源使用iOS的CoreLocation框架，通過GPS、WiFi 或是蜂窩網路來獲取位置的更新。它會試圖儘可能頻繁的獲取更精確的資訊。

       AGSSimulatedLocationDisplayDataSource

       該資料來源可以使你基於任何線狀幾何體來模擬位置更新。線中的每個頂點被用來發射位置更新。

//The polyline geometry along which location updates should be simulated
AGSPolyline* route = ...;

//Create the data source. Assign the geometry.
AGSSimulatedLocationDisplayDataSource* simulatedDS = [[AGSSimulatedLocationDisplayDataSource alloc] init];
[simulatedDS setLocationsFromPolyline:route];

//Set data source 
self.mapView.locationDisplay.dataSource = simulatedDS;

        AGSGPXLocationDataSource

        該資料來源使用GPS檔案中的第一條蹤跡或是道路來模擬位置更新。

//Create the data source using a GPX file on the web
NSURL* url = [NSURL URLWithString:@"http://www.topografix.com/fells_loop.gpx"];
AGSGPXLocationDataSource* gpxDS = [[AGSGPXLocationDataSource alloc] initWithURL:url];

//Or, create the data source using a GPX file on the device
NSString* pathToGPXOnDevice = ...;
AGSGPXLocationDataSource* gpxDS = [[AGSGPXLocationDataSource alloc] initWithPath:pathToGPXOnDevice];

//Set data source 
self.mapView.locationDisplay.dataSource = gpxDS;

       自動掃描模式

       地圖在接收到位置更新時，提供了一些預設來定義地圖的行為。

       關閉模式

       在這種模式下，地圖僅更新在地圖上的位置符號的位置，它並不重新進行中心定位。因此，位置符號可能在相應位置更新時移出螢幕。

       預設模式

       在這種模式下，當定位符號移動到一個“漫遊程度”時，地圖會試圖通過重新中心化位置符號來儘量保持其在螢幕上。因此，定位符號可能在漫遊範圍內自由移動。但是隻要定位符號退出漫遊模式，地圖就會重新使其中心化。

       預設情況下，漫遊範圍通常是地圖可視範圍的一半大小，但是你也可以通過修改AGSLocationDisplay中的wanderExtentFactor屬性來自定義漫遊範圍。如果值為1，意味著漫遊範圍等於地圖的可視範圍，並且定位符號可能在地圖重新中心化之前移動到地圖邊緣。如果值為0，則意味著無止境的漫遊範圍，而地圖也會在任何一個位置更新處進行中心化。

self.mapView.locationDisplay.autoPanMode = AGSLocationDisplayAutoPanModeDefault ;
self.mapView.locationDisplay.wanderExtentFactor = 0.75; //75% of the map's viewable extent

       導航模式

       這種模式最適合於車載導航。在這種模式下，定位符號被固定在螢幕的一個點，並且總是指向裝置的頂端邊緣方向。地圖根據位置更新來移動和旋轉，並且指向裝置的移動行駛的方向。因此，雖然定位符號看起來像是靜止的，但是在它下面的地圖卻是在移動和旋轉著。

        定位符號的位置可以通過改變AGSLocationDisplay中的navigationPointHeightFactor屬性來進行調整。如果其值為0，意味著定位符號應被放在地圖的底部邊緣，如果值為1則放在頂部邊緣。而如果是0和1之間的值，定位符號就會處於從底部邊緣到頂部邊緣中心線的某個位置。

self.mapView.locationDisplay.autoPanMode = AGSLocationDisplayAutoPanModeNavigation ;
self.mapView.locationDisplay.navigationPointHeightFactor  = 0.25; //25% along the center line from the bottom edge to the top edge

        羅盤導航模式

        這種模式適用於使用者行走的情況。和在導航模式中一樣，定位符號也是被固定在螢幕上的一個點，並總是指向裝置的邊緣。然而，地圖的旋轉是根據使用者相對於磁北的方位，而不是裝置的移動方向。因此，當用戶圍繞他們的位置轉動時，地圖上會反映出處在使用者前面的東西。

       定位符號的位置也可以像導航模式中的那樣通過修改navigationPointHeightFactor來調整。

self.mapView.locationDisplay.autoPanMode = AGSLocationDisplayAutoPanModeCompassNavigation ;
self.mapView.locationDisplay.navigationPointHeightFactor  = 0.5; //50% along the center line from the bottom edge to the top edge

       終止位置展示

       要終止裝置位置的展示，呼叫stopDataSource方法。

[self.mapView.locationDisplay stopDataSource];

       自定義定位符號

       SDK提供了三種預設的影象供定位符號使用，這些影象為：LocationDisplay.png、LocationDisplayCourse.png和LocationDIsplayHeading.png，它們都包含在在ArcGIS.bundle中。

        根據所使用的模式和位置更新所提供的資訊型別，這三種預設的影象將會被應用於定位符號。

       在關閉模式、預設模式和導航模式下，LocationDisplay.png影象在位置資訊可用情況下才會被使用。LocationDisplayCourse.png影象在位置和路線（移動方向）都可用的情況下才會被使用。在關閉和預設模式下，LocationDisplayCourse.png影象會適度的旋轉來顯示裝置的移動方向，而在導航模式種，則是地圖進行旋轉。

        注意：路線資訊只有當裝置以較快速度移動時才可用。這就是為什麼只有裝置在行駛的車輛中移動時，地圖上才會展示LocationDisplayCourse.png影象。

        在羅盤導航模式下，LocationDisplayHeading.png影象被用來展示裝置的位置的方位。

        當然，你也可以利用你自己的PNG影象來改變定位符號。並且你的圖片必須具有與預設圖片相同的名稱並作為Xcode專案的一部分。這些影象在您的Xcode專案中會優先於ArcGIS.bundle中預設的圖片。如果可能的話，建議你的工程也包含高解析度的影象來供視網膜顯示裝置使用，並命名這些高解析度版本為[email protected], [email protected], and [email protected]

        注意：影象名字是區分大小寫的。

        在callout中展示位置資訊

        你可以利用AGSCallout物件來展示地圖上的位置資訊。要展示一個callout，你需要設定callout的代理。你可以通過使你的類（一般為view controller）遵從<AGSCalloutDelegate> 協議來實現這個功能。

@interface ViewController : UIViewController <AGSCalloutDelegate>
...
}

        接下來，設定callout的代理

self.mapView.callout.delegate = self;

        最後，呼叫協議中的 callout：willshowForLocationDisplay：方法。

-(BOOL)callout:(AGSCallout *)callout willShowForLocationDisplay:(AGSLocationDisplay *)locationDisplay {
    
    callout.title = @"<title text>";
    callout.detail = @"<detail text>";

    return YES;
}

        訪問位置資訊

       AGSLocationDisPlay以兩種方式提供了裝置的位置：

       1）location屬性包含了由底層資料來源提供的資訊。位置座標將會是在資料來源選擇的空間參考系下。例如，如果資料來源的型別是AGSCLLocationManagerLocationDisplayDataSource，那麼座標系為WGS84座標系。

       2）mapLocation方法提供了相同的位置資訊，但是，而其座標被投影到了地圖的空間參考系下。

       監聽位置更新

        AGSLocationDisplay種的位置屬性是相容KVO模式的。你可以將一個觀察器跟位置屬性相關聯，以此來監聽位置的更新。

- (void)registerAsObserver {
  [ self.mapView.locationDisplay addObserver:self
                      forKeyPath:@"location"
                         options:(NSKeyValueObservingOptionNew)
                         context:NULL];
}

- (void)observeValueForKeyPath:(NSString *)keyPath
                      ofObject:(id)object
                        change:(NSDictionary *)change
                       context:(void *)context {
  if ([keyPath isEqual:@"location"]) {
   NSLog(@"Location updated to %@", [self.mapView.locationDisplay mapLocation]);
  }
}