位置识别编程指南

一、获得用户的位置
使用CoreLocation框架。
1、如果你的应用基于位置来正确运行,你应该在你的Info.plist中包括UIRequiredDeviceCapabilities键.App Store使用这个信息来阻止没有定位的设备下载该应用。
UIRequiredDeviceCapabilities键对应一个字符串数组,包括:
1)location-services字符串--如果你请求一般的定位服务
2)gps--如果你请求GPS级的精度
如果你的应用需要定位,但是没有定位也能正常运行,就不要包含这个键。

2、获得用户的定位
有2种方法:
1)标准的定位服务
2)显著的位置变化定位服务:只在4.0以后有效。


3、确定定位服务是否可用:
1)用户可以在设置程序中禁用定位服务
2)用户可以对某个应用拒绝定位服务
3)设备可能在飞行模式,并且不能启用需要的硬件。
因为这些原因,推荐你调用[CLLocationManager locationServicesEnabled]来确定定位服务是否可用。
使用[CLLocationManager authorizationStatus]==kCLAuthorizationStatusDenied检查定位服务是否对本app禁止。


4,启动标准的定位服务:
CLLocationManager *locationManager = [[CLLocationManager alloc] init];
locationManager.delegate = self;
locationManager.desiredAccuracy = kCLLocationAccuracyKilometer;
// Set a movement threshold for new events.
locationManager.distanceFilter = 500;
[locationManager startUpdatingLocation];


5、启动Significant-Change Location Service:
[locationManager startMonitoringSignificantLocationChanges];
启动此服务后,即使应用没有被启动也可以接收通知,并且进入到后台状态来处理事件。但是不能让程序的后台任务超过10分钟

6, 从服务中接收位置数据
locationManager:didUpdateToLocation:fromLocation
locationManager:didFailWithError:


7、监视Shape-Based Regions:
在iOS4.0以后,当用户穿过地理边界时应用可以使用region monitoring来被通知。这个通知即使应用没有被启动也可以接收,并且进入到后台状态来处理事件。(推断:应该和startMonitoringSignificantLocationChanges一样,不能让程序的后台任务超过10分钟)

8、确定Region Monitoring的可用性
有几种原因可能导致Region Monitoring可能不可用:
1)设备可能没有硬件来支持region Monitoring
2)用户可能禁用了定位服务
3)设备可能出于飞行模式。
因此,你需要调用[CLLocationManager regionMonitoringAvailable]和[CLLocationManager regionMonitoringEnabled]来确定其是否可用。

9、定义一个要监视的Region:
要监视一个区域,你需要定义个region并且注册其到系统。Regions使用CLRegion类来定义,支持创建一个圆形区域。你创建的Region必须包括地理区域的数据和唯一的标志字符串。要注册一个Region,你需要调用CLLocationManager对象的startMonitoringForRegion:desiredAccuracy:方法。
例子:
// 如果不支持RegionMonitoring,就不要创建Region了
if ( ![CLLocationManager regionMonitoringAvailable] ||
![CLLocationManager regionMonitoringEnabled] )
return NO;

// 如果半径太大,注册会自动失败,因此当半径太大时,将其设置为最大值
CLLocationDegrees radius = overlay.radius;
if (radius > self.locManager.maximumRegionMonitoringDistance)
radius = self.locManager.maximumRegionMonitoringDistance;

// 创建一个Region并开始监视它
CLRegion* region = [[CLRegion alloc] initCircularRegionWithCenter:overlay.coordinate radius:radius identifier:identifier];
[self.locManager startMonitoringForRegion:region desiredAccuracy:kCLLocationAccuracyHundredMeters];

[region release];

...
在注册之后立即就开始了监视Region,但是不要奢望马上就收到一个事件。只有穿过边界时才会产生事件。因此,如果在注册时,用户的位置已经在区域内,locationManager不会产生事件的。
你必须明智的使用Regions Monitoring。Regions是一个系统分享资源,并且其数量是有上限的。因此,Core Location限制一个应用同时监听的Regions数量。你应该考虑只监听用户临近位置的Region,当用户的位置变化时,你可以移除远处的Regions并添加近处的Regions来监听。如果你尝试注册一个Region并且没有空间了,LocationManager会调用locationManager:monitoringDidFailForRegion:withError:方法,并传递一个kCLErrorRegionMonitoringFailure错误码。

10、处理Region的穿过边界事件
locationManager:didEnterRegion:
locationManager:didExitRegion:


11、在后台获得定位事件
有几种方法:
1)使用Signicant Location Change服务: [locationManager startMonitoringSignificantLocationChanges];
2)使用标准的定位服务: 在Info.plist中的UIBackgroundMode键中指定location


12、保护电池电量的技巧
1)在你不需要定位的时候关闭定位服务:
2)使用significant-change 定位服务
3)使用低精度的desired accuracy
4)如果是周期性的轮询服务,那在周期中间关闭定位服务

二、获得方向相关的事件
Core Location支持两种方法来获得方向相关的信息:
1)有磁力计(magnetometer)的设备可以报告设备指向的方向,也称为heading。
2)有GPS的设备可以报告设备移动的方向,也称为course。

记住,heading和course不表示相同的信息。

1、如果你的应用需要方向相关的信息才能正确运行,需要在Info.plist中指定UIRequiredDeviceCapabilities键,其值为一个字符串的数组,包括:
1)magnetometer---对应heading
2)gps--对应course

2、获得Heading-Related事件:步骤:
1)实例化CLLocationManager对象
2)确定[CLLocationManager headingAvailable]
3)指定代理
4)如果你想获得真实的north values,需要启用标准服务
5)调用startUpdatingHeading开始投递heading事件

如下例:
CLLocationManager* locManager = [[[CLLocationManager alloc] init] autorelease];
locManager.delegate = self;

// Start location services to get the true heading.
locManager.distanceFilter = 1000;
locManager.desiredAccuracy = kCLLocationAccuracyKilometer;
[locManager startUpdatingLocation];

// Start heading updates.
if ([CLLocationManager headingAvailable]) {
locManager.headingFilter = 5;
[locManager startUpdatingHeading];
}


代理函数:locationManager:didUpdateHeading:方法。
一旦你收到一个新的事件,你需要检查headingAccuracy属性来确保数据有效。另外,如果你正在使用true heading value,你应该在使用它之前,检查其是否包含一个有效的值。
- (void)locationManager:(CLLocationManager *)manager didUpdateHeading:(CLHeading *)newHeading {
if (newHeading.headingAccuracy < 0)
return;

// Use the true heading if it is valid.
CLLocationDirection theHeading = ((newHeading.trueHeading > 0) ? newHeading.trueHeading : newHeading.magneticHeading);
self.currentHeading = theHeading;
[self updateHeadingDisplays];

}

3、在用户移动时获得course信息
拥有GPS硬件的设备可以生成设备的当前course和速度的信息。crouse信息用来指示设备正在移动的方向,并且不需要反应设备自身的方向。因此,主要用来导航。
实际的course和speed消息在CLLocation对象中返回.
newLocation.speed
newLocation.course


三、地理编码位置数据 Geocoding Location Data:
1、关于Geocoder对象:
一个geocoder对象使用网络服务来在(经度、纬度)和地标之间转换,地标为一组数据的集合,例如街道、城市、州和国家信息。Reverse geocoding(逆地理编码)是将(经度、纬度)转换为地标。Forward geocoding(正地理编码)是将位置名称信息转换为(经度、纬度)值。逆地理编码在所有的iOS版本中都可用,但正地理编码仅在iOS5.0以后支持。
因为地理编码服务需要网络,因此,如果设备出于飞行模式或者设备当前没有网络,地理编码对象不能连接它需要的服务,因此肯定返回一个错误。

2、转换坐标到Place Name信息:
在iOS中,你可以使用CLGeocoder类来处理逆地理编码。MKReverseGecoder在iOS5.0以后被弃用。

3、使用CLGeocoder获得地标信息
创建一个CLGeocoder类的实例,并调用
[gecoder reverseGeocodeLocation:completionHandler:]方法
例子:

CLGeocoder *gecoder=[[CLGeocoder alloc]init];
[geocoder reverseGeocodeLocation:location completionHandler:^(NSArray *placemarks,NSError *error){
if ([placemarks count]>0){
annotation.placemark=[placemark objectAtIndex:0];
...
}
}];

...

4、从Reverse Geocoder中获得地标信息:
MKReverseGeocoder *theGeocoder=[[MKReverseGeocoder alloc]initWithCoordinate:location.coordinate];
theGeocoder.delegate=self;
[theGeocoder start];

代理函数为:
-(void)reverseGeocoder:(MKReverseGeocoder *)geocoder didFindPlaceMark:(MKPlaceMark *)place
-(void)reverseGeocoder:(MKReverseGeocoder *)geocoder didFailWithError:(NSError *)error

5、转换Place Names为Coordinate
[geocoder gecodeAddressString:@"1 Infinite Loop" completionHandler:^(NSArray *placeMarks,NSError *error){
for (CLPlacemark *aPlaceMark in placemarks){
//CLPlacemark对象包含地理位置信息,当然包括经纬度
}
}];


四、显示地图
Map Kit框架
1、理解Map Geometry
一个map view扁平的表现一个球形对象--地球。你需要了解一些关于如何在map view中指定点,并且这些点如何转换为地球表面的坐标。如果你打算防止自定义的内容,如overlays,到地图上,理解地图坐标系统是非常重要的。

2、地图坐标系统
地球的三维坐标如何被映射到地图的二维坐标上的?
Map Kit使用Mercator地图映射。
你如何指定地图上的数据点取决于你打算如何使用它们。Map Kit支持3中基本的坐标系统来指定地图数据点:
1)A map coordinate:是地图的球形表示的(经度,纬度)。地图坐标系主要的方法来指定地球上的位置。使用CLLocationCoordinate2D结构。使用MKCoordinateSpan和MKCoordinateRegion结构来指定区域。
2)A map point:是Mercator地图映射之后的(x,y)点。使用地图点来计算地图相关的计算,而不是map坐标,因为他们简化了计算。在应用中,你主要使用map point来指定shape和自定义的overlay的position。使用MKMapPoint结构。使用MKMapSize和MKMapRect结构来指定区域。
3)A Point是UIView坐标系中的graphical单元。在绘制view的内容之前,Map Piont和Map Coordinate必须被映射为Point。使用CGPoint,CGSize和CGRect。
在大多数情况中,你应该使用的坐标系取决于你要使用的Map Kit界面。当你要存储实际的数据到文件中时,map coordinate是首选。
Core Location也是用map coordinate来指定位置值。

3、坐标系统间的转换:
Convert From Convert To Conversion routines
Map Coordinate Points convertCoordinate:toPointToView:(MKMapView)
convertRegion:toRectToView:(MKMapView)
Map Coordinate Map Points MKMapPointForCoordinate
Map Points Map Coordinates MKCoordinateForMapPoint
MKCoordinateRegionForMapRect
Map Points Points PointForMapPoint:(MKOverlayView)
rectForMapRect:(MKOverlayView)
Points Map Coordinates convertPoint:toCoordinateFromView:(MKMapView)
convertRect:toRegionFromView:(MKMapView)
Points Map Points mapPointForPoint:(MKOverlayView)
mapRectForRect:(MKOverlayView)


4、添加一个Map View到用户界面
MKMapView
5、配置Map的属性
1)设置Map的可见部分:region属性,是一个MKCoordinateRegion结构
typedef struct {
CLLocationCoordinate2D center;
MKCoordinateSpan span;
} MKCoordinateRegion;
有趣的是span。span类似于一个矩形的宽度和高度值,但是通过map coordinate指定,因此,通过degree(度)、minutes(分)、seconds(秒)来度量。latitude(纬度)的一度大约为111km,但是longitude(经度)的一度不同与纬度。在赤道,经度的一度大约为111km,但是在极点,这个值为0.如果你选择使用米来指定span,你可以使用MKCoordinateRegionMakeWithDistance来创建一个region data 结构,用米而不是用度。
你指定的region属性的值(或者使用setRegion:animated:方法)通常和实际存储在属性中的值不一样。设置region的span只是定义了你想要查看的矩形,但也隐式设置了map view的缩放级别。map view不能显示任意的缩放级别,并且必须调整你设置的region来匹配它支持的缩放级别。它选择能容纳你的整个region可见,同时又尽可能填满屏幕的缩放级别。相应地,它然后调整region属性。要查找region的结果而不实际更改region的属性,你可以使用map view的regionThatFits:方法。

2)缩放和Panning 地图内容:
a)Pan 地图:更改centerCoordinate属性的值 或者 setCenterCoordinate:animated:方法
b)更改缩放级别:更改region属性的值或setRegion:animated:方法

如果只是要Pan地图,需要使用第一种方法,如果你更改region属性的center属性,通常会导致缩放级别发生变化。

CLLocationCoordinate2D mapCenter = myMapView.centerCoordinate;
mapCenter = [myMapView convertPoint:CGPointMake(1, (myMapView.frame.size.height/2.0)) toCoordinateFromView:myMapView];
[myMapView setCenterCoordinate:mapCenter animated:YES];


要缩放地图,修改region的span,要zoom in,就设置一个更小的值给span,要zoom out,就设置一个更大的值给span。
MKCoordinateRegion theRegion = myMapView.region;
// Zoom out
theRegion.span.longitudeDelta *= 2.0;
theRegion.span.latitudeDelta *= 2.0;
[myMapView setRegion:theRegion animated:YES];


3)在地图上显示用户的当前位置
设置showsUserLocation属性为YES
。这样做导致map view使用Core Location来查找用户的位置并添加一个MKUserLocation类型的annotation到地图上。

6、响应用户与地图的交互
MKMapView报告显著的map-related事件给其代理。代理遵循MKMapViewDelegate协议。可以响应如下事件:
1)更改地图的可见region
2)从网络上加载map 碎片
3)更改用户的位置
4)更改相关的annotation和overlay

五、Annotating Maps
1、添加Annotations到地图上:
要实现这个必须提供两个对象:
1)遵守MKAnnotation协议的对象(即annotation对象)
2)一个继承自MKAnnotationView类的视图,用来绘制annoatation的表现(及annotation view)

Map Kit提供了一些标准的annotation视图,并且你可以定义自己的annotation views。

2、添加Annotation到地图上的清单:
1)定义一个合适的annotation对象,使用下面的选项:
a)使用MKPointAnnotation类来实现一个简单的annotation。
b)定义一个自定义的遵循MKAnnotation协议的对象
2)定义一个annotation view来表示屏幕上的数据。
a)如果annotation可以被一个静态图像代表,那就创建一个MKAnnotationView类的实例,并指定image属性
b)如果你想使用一个标准的annotation,那就创建一个MKPinAnnotationView类的实例
c)如果静态图像不合适,那就子类化MKAnnotationView,并实现自定义的draw代码。
3)实现mapView:viewForAnnotation:方法---在你的mapView代理中。并返回一个annotationView。
4)使用addAnnotation:或addAnnotations:方法来添加addnotation对象。


3、定义自定义的Annotation对象
主要是遵守MKAnnotation协议:
必须有coordinate只读属性

4、使用标准的Annotation Views:
MKAnnotationView 和 MKPinAnnotationView(MKAnnotationView的子类)
MKAnnotationView适用于只展示一幅图像。通过image属性,还可以指定centerOffset属性来移动中心点。

5、定义自己的Annotation View
子类化MKAnnotationView,你可以继续使用image属性,并重载drawRect:方法。

6、在代理中创建Annotation Views
-(MKAnnotationView *)mapView:(MKMapView *)mapView viewForAnnotation:(id<MKAnnotation>)annotation{
}

7、管理地图的Annotation对象:
可以在mapView:regionWillChangeAnimated:和mapView:regionDidChangeAnimated:方法中添加和移除annotations
在iOS4.0以后,你可以使用MKMetersBetweenMapPoints方法来获得两个点之间的绝对距离。你还可以使用MKMapRectIntersetsRect函数来查找任何的交集。

8、标记你的AnnotationView为可拖动:
1)在你的annotation对象中,实现setCoordinate:方法来允许map view更新annotation的coordinate点。
2)设置其draggable属性为YES。

当用户拖动annotation时,委托收到mapView:annotationView:didChangeDragState:fromOldState:方法


9、在地图上显示OverLay:
和Annotation类似:
1)需要实现了MKOverLay协议的对象(即overlay对象)
2)一个视图(继承自MKOverlayView类)(即overlay视图)

10、添加overlay到地图的清单:
1)定义一个overlay对象:
a)使用MKCircle、MKPolygon、MKPolyline类 等
b)子类化MKShape或MKMultiPoint来创建自定义的overlay对象。
c)使用一个已存在的类并遵守MKOverlay协议。
2)定义一个overlay视图:
a)对于标准图形,使用MKCircleView、MKPolygonView、MKPolylineView
b)对于继承自MKShape的自定义形状,定义合适的MKOverlayPathView的子类来渲染形状。
c)对于其它自定义的形状和overlay,子类化MKOverlayView并实现drawRect:方法
3)实现代理函数: mapView:viewForOverlay: 并返回MKOverlayView
4)使用addOverlay:方法添加overlay


11、使用标准的Overlay对象和视图:
MKCircle、MKPolygon、MKPolyline为overlay对象。
MKCircleView、MKPolygonView、MKPolylineVIew为overlay视图。

12、定义自定义的Overlay对象:
子类化MKShape或MKMultiPoint或者采用MKOverlay协议。
1)必须有coordinate可读属性
2)一个bounding rectangle,完全包含了overlay的内容。

13、定义自定义的Overlay视图:
子类化MKOverlayView,并重载
drawMapRect:zoomScale:inContext:
canDrawMapRect:zoomScale:

14、从代理中创建Overlay视图
mapView:viewForOverlay:方法

15、管理地图的Overlay对象:
overlays属性
代理函数mapView:didAddOverlayViews:方法,然后使用MKMapRectIntersectsRect函数来看看已经添加的overlay与其它的overlay是否有交集。

16、使用overlay当作annotations
MKOverlay协议遵循MKAnnotation协议。因此,所有的overlay对象都可以当作annotation对象来使用

你可能感兴趣的:(编程)