推荐上车点-iOS 最后更新时间: 2021年01月22日

[MAHotSpotManager sharedInstance].accessKey = "your key";
self.hotSpotController = [[MAHotSpotController alloc] initWithMapView:self.mapView delagate:self];

/**
* @brief 在对应的地图delegate方法中调用此方法
* @param mapView 地图
* @param wasUserAction 是否用户触发
*/
- (void)mapView:(MAMapView *)mapView mapWillMoveByUser:(BOOL)wasUserAction {
    [self.hotSpotController mapView:mapView mapWillMoveByUser:wasUserAction];
}

/**
* @brief 在对应的地图delegate方法中调用此方法
* @param mapView 地图
* @param wasUserAction 是否用户触发
*/

- (void)mapView:(MAMapView *)mapView mapDidMoveByUser:(BOOL)wasUserAction {
    [self.hotSpotController mapView:mapView mapDidMoveByUser:wasUserAction];
}

/**
* @brief 在对应的地图delegate方法中调用此方法
* @param mapView 地图
* @param wasUserAction 是否用户触发
*/
- (void)mapView:(MAMapView *)mapView mapDidZoomByUser:(BOOL)wasUserAction {
    [self.hotSpotController mapView:mapView mapDidZoomByUser:wasUserAction];
}

/**
* @brief 在对应的地图delegate方法中调用此方法
* @param mapView 地图
* @param views annotationView
*/
- (void)mapView:(MAMapView *)mapView didAddAnnotationViews:(NSArray *)views {
    [self.hotSpotController mapView:mapView didAddAnnotationViews:views];
}

/**
* @brief 在对应的地图delegate方法中调用此方法
* @param mapView 地图
* @param annotation 标注
* @return 返回上车点功能需要的annotationview，一类是上车点，一类是大头针锚点
*/
- (MAAnnotationView *)mapView:(MAMapView *)mapView viewForAnnotation:(id <MAAnnotation>)annotation {
    MAAnnotationView *ret = [self.hotSpotController mapView:mapView viewForAnnotation:annotation];
    if(ret) {
        return ret;
    } else {
        //do your job here
    }
    
    return nil;
}

///创建上车点view
- (MAAnnotationView *)createHotSpotViewWith:(MAHotSpotAnnotation *)annotation reuseIdentifier:(NSString *)reuseIdentifier controller:(MAHotSpotController *)controller {
    MAHotSpotAnnotationView *ret = [[MAHotSpotAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:reuseIdentifier];
    ret.animatingCircleImage = [UIImage imageNamed:@"spotCircle"];
    ret.centerDotImage = [UIImage imageNamed:@"centerDot"];
    return ret;
}

///创建大头针锚点view
- (MAAnnotationView *)createAnchorPinViewWith:(MAPointAnnotation *)annotation reuseIdentifier:(NSString *)reuseIdentifier controller:(MAHotSpotController *)controller {
    MAPinAnnotationView *view = [[MAPinAnnotationView alloc] initWithAnnotation:annotation reuseIdentifier:reuseIdentifier];
    view.canShowCallout = YES;
    view.pinColor = MAPinAnnotationColorGreen;
    return view;
}

@interface MAHotSpotManager : NSObject

///服务授权的key
@property (nonatomic, copy) NSString *accessKey;

/**
 * @brief 单例方法
 * @return 单例对象
 */
+ (instancetype)sharedInstance;

/**
 * @brief 查询周围上车点
 * @param request 请求
 * @param callback 结果回调
 * @return NSOperation 对象
 */
- (NSOperation *)queryHotSpotsWith:(MAHotSpotQueryRequest *)request callback:(void(^)(MAHotSpotQueryResponse *response, NSError* error))callback;

@end

///如果返回NO，preCoord为上次请求的中心点坐标，absorbedAnno返回指定要自动吸附到的上车点，clearPrevAnnos返回是否删除上次的上车点。如不实现则执行默认策略：zoomLevel<15：不请求，移动超过1000米清空上车点；zoomLevel>=15: 锚点和已有上车点屏幕距离50像素内，自动吸附且不请求新的，否则不清空原来的且请求新的。
- (BOOL)shouldSendSpotQueryRequest:(CLLocationCoordinate2D)centerCoord
                          preCoord:(CLLocationCoordinate2D)preCoord
                      absorbedAnno:(MAHotSpotAnnotation **)absorbedAnno
                    clearPrevAnnos:(BOOL*)clearPrevAnnos
                        controller:(MAHotSpotController *)controller;

///请求返回后，判断要不要自动吸附到最近上车点, 如不实现则执行默认策略：如果地图zoomLevel小于15则返回NO，zoomLevel不小于15且地图中心点距离上车点距离小于50屏幕坐标返回YES。
- (BOOL)shouldAutoAbsorbedToAnnotation:(MAHotSpotAnnotation *)anno controller:(MAHotSpotController *)controller;

///如不实现此代理方法，当做返回YES处理
- (BOOL)shouldSendRegeoQueryRequest:(CLLocationCoordinate2D)centerCoord controller:(MAHotSpotController *)controller;

///如不实现，当做返回formattedAddress处理
- (NSString *)regeoDisplayStringWith:(AMapReGeocodeSearchResponse *)response controller:(MAHotSpotController *)controller;

///大头针锚点跳动动画回调, 如不实现则走默认动画效果
- (void)startAnchorPinViewAnimating:(MAAnnotationView *)anchorPinView controller:(MAHotSpotController *)controller;

///错误回调, 如果errorcode==MAHotSpotErrorSpots时为请求上车点错误，其他为逆地理查询错误
- (void)hotSpotController:(MAHotSpotController *)controller didFailWithError:(NSError *)error;

///上车点允许获取和显示的最小地图缩放级别，默认15
@property (nonatomic, assign) CGFloat minMapZoomLevel;

///返回上车点个数，最大支持3个
@property (nonatomic, assign) int spotSearchCount;

///如果实现此方法，内部将不请求附近上车点，改由外部通过回调返回上车点信息
- (void)queryHotSpotsWith:(CLLocationCoordinate2D)centerCoord
              sucCallback:(void(^)(NSArray<MAHotSpotInfo*> *resultSpots))sucCallback
             failCallback:(void(^)(BOOL isCancelled, NSString* errDescription))failCallback
               controller:(MAHotSpotController *)controller;

/**
 *@brief 外部传入上车点信息做更新，适用于外部自己控制上车点获取
 */
- (void)updateHotSpotsWith:(NSArray<MAHotSpotInfo*> *)spots;