ArcGIS for iOS 开发系列(3) – 基础篇-“Hello World Map”

    搞定了环境配置，我们赶快开始ArcGIS for iOS开发吧，按惯例首先创建一个“Hello World Map”程序，使用在上一节中我们新建好的项目。

第一步：配置界面。

    找到“ViewController_iPhone/iPad.xib”（分别针对了iPhone和iPad不同的布局），在内容窗口中可以看到只有一个空白的View视图，右下侧的工具窗口切换到组件对象，其中列举了Cocoa Touch库的全部可视化组件，定位到“View”对象，将其直接拖到内容窗口里，一个新的子视图就添加成功了，同时还添加了Constraints（Xcode4.5的新特性，宽高布局限制），把新添加的视图重命名为“Map View”。

图3-1 添加地图视图

    选中“Map View”视图，在右上侧的属性窗口切换到“inspector”项，修改其继承类为“AGSMapView”。

图3-2 修改Map View的继承类为AGSMapView

    然后“Command + s”保存。

第二步：添加代码。

1）             头文件“ViewController.h”，添加ArcGIS头文件引用，并声明一个地图控件的属性，代码如下：

#import <UIKit/UIKit.h>
#import <ArcGIS/ArcGIS.h>
 
@interface TMViewController : UIViewController
@property(nonatomic,strong)IBOutletAGSMapView *mapView;
@end

    * @property关键字：公共属性标记，相当与“Get-Set”构造，4.0以前的版本中与synthesizes成对使用，4.0之后不再需要synthesizes。

    * IBOutlet关键字：界面 “插座”标记（以前的界面编辑工具Interface Builder，4.0后被集成进了Xcode，“插座”，表示与界面元素连接的属性对象。与之呼应的还有一个IBAction，表示界面元素的事件响应。

    不想敲太多这种机械代码的话，还可以在界面视图中完成，选中要连接的界面对象，右键拖动到代码窗口，会弹出一个小对话框，输入属性名称mapView，确定后会自动生成这个属性。

图3-3 自动生成属性

2）             打开类文件“ViewController.m” ，在viewDidLoad方法中添加如下代码：

- (void)viewDidLoad
{
    [superviewDidLoad];
    // 
    //基础底图，使用的是北京捷泰科技有限公司提供的在线地图，更多地图请登陆ArcGIS Online中国网址查询（http://www.arcgisonline.cn）
    NSString *str_URL = @"http://www.arcgisonline.cn/ArcGIS/rest/services/ChinaOnlineCommunity/MapServer";
    NSURL *url_Tiled = [NSURLURLWithString:str_URL];
    AGSTiledMapServiceLayer *tiledLyr = [AGSTiledMapServiceLayertiledMapServiceLayerWithURL:url_Tiled];
    [self.mapViewaddMapLayer:tiledLyrwithName:@"TiledLayer"];
    //动态图层，使用ArcGIS Online的全球人口数据
    NSString *str_URL_1 = @"http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Demographics/ESRI_Population_World/MapServer";
    NSURL *url_Dynamic =[NSURLURLWithString:str_URL_1];
    AGSDynamicMapServiceLayer *dynamicLyr =[AGSDynamicMapServiceLayerdynamicMapServiceLayerWithURL:url_Dynamic];
    UIView<AGSLayerView>*dynamicLyrView = [self.mapViewaddMapLayer:dynamicLyrwithName:@"PopulationLayer"];
    //设置动态图层透明度
    dynamicLyrView.alpha = 0.3;
    //设定地图初始化显示范围为中国
       AGSEnvelope *chinaEnv = [AGSEnvelopeenvelopeWithXmin:7800000.00
                                                    ymin:44000.00
                                                    xmax:15600000.00
                                                     ymax:7500000.00
                                         spatialReference:self.mapView.spatialReference];
       [self.mapViewzoomToEnvelope:chinaEnvanimated:YES];
}

第三步：绑定界面与代码。

    Xcode里绑定界面元素与代码对象的操作方法很艺术，选中界面视图的File’s Owner，右上侧属性窗口切换到“Connections”项，“Outlets”里有一个mapView对象，这就是我们在ViewController.h中声明的地图控件属性。拖动其右侧的空心小圆圈，牵引到左侧界面对象“Map View” 上，绑定成功后，小圆圈就变成实心了的，再次保存。

图3-3 绑定地图控件与代码对象

第四步：保存工程，“Command+ r ”运行并调试“HelloWorld Map”。

图3-4 在iPhone5模拟器中运行“Hello World Map”

    *REST和JSON大家都应该很熟悉了，ArcGIS Server发布的服务支持SOAP、REST两种结构，而Web和移动API中都使用其REST服务接口，比如上文中提到的地图服务：http://yourServer/ArcGIS/rest/services/Demographics/ESRI_Population_World/MapServer。数据交互使用的是更为灵活高效的JSON格式，ArcGIS框架中集成了第三方库json-framework来负责中间层的数据转换，开发者一般不用操心。