hlpgeojson

HLPGeoJSON.h

• Mantleを使ったオブジェクトマッピング
• MapServiceの歩行空間ネットワークデータH22（GeoJSON形式）をObjective-Cのオブジェクトのマップ
• TODO: H30版対応

継承関係

• HLPGeoJSONFeature
  • HLPObject
    • HLPLocationObject
      • HLPNode（ノード）
      • HLPFacility（施設情報）
        • HLPPOI（POI）
      • HLPEntrance（出入口）
    • HLPLink（リンク）
      • HLPCombinedLink
  • HLPLandmark（ランドマーク＝施設情報、出入口等を統合したもの、目的地リストに使用）

GeoJSONマッピング

GeoJSONのGeometry

@interface HLPGeometry : MTLModel<MTLJSONSerializing, NSCoding>
@property (nonatomic, readonly) NSString *type;
@property (nonatomic, readonly) NSArray *coordinates;

- (void) updateCoordinates:(NSArray*)coordinates;
- (instancetype)initWithLocations:(NSArray*) locations;
- (HLPLocation*)point;
- (NSArray<HLPLocation*>*)points;
@end

GeoJSONのFeature

@interface HLPGeoJSONFeature : MTLModel<MTLJSONSerializing, NSCoding> {
@protected
    NSString *_type;
    HLPGeometry *_geometry;
    NSDictionary *_properties;
}
@property (nonatomic, readonly) NSString *type;
@property (nonatomic, readonly) HLPGeometry *geometry;
@property (nonatomic, readonly) NSDictionary *properties;
- (HLPLocation*)nearestLocationTo:(HLPLocation*) location;
@end

GeoJSON

@interface HLPGeoJSON : MTLModel<MTLJSONSerializing, NSCoding>
@property (nonatomic, readonly) NSString *type;
@property (nonatomic, readonly) NSArray<HLPGeoJSONFeature*> *features;
@end

歩行空間ネットワークデータマッピング

HLPObjectのカテゴリ

typedef enum {
    HLP_OBJECT_CATEGORY_LINK=1,
    HLP_OBJECT_CATEGORY_NODE,
    HLP_OBJECT_CATEGORY_PUBLIC_FACILITY,
    HLP_OBJECT_CATEGORY_ENTRANCE,
    HLP_OBJECT_CATEGORY_TOILET
} HLPObjectCategory;

HLPObject （歩行空間ネットワークデータオブジェクトの基底クラス）

@interface HLPObject : HLPGeoJSONFeature {
@protected
    NSString *__id;
    NSString *__rev;
    HLPObjectCategory _category;
}
@property (nonatomic, readonly) NSString *_id;
@property (nonatomic, readonly) NSString *_rev;
@property (nonatomic, readonly) HLPObjectCategory category;
- (void) updateWithLang:(NSString*)lang;

@end

HLPLandmark （目的地になりうる）

@class HLPNode; // 定義前なので@classをつけて宣言

@interface HLPLandmark : HLPGeoJSONFeature
@property (nonatomic, readonly) NSString *category;
@property (nonatomic, readonly) NSString *exit;
@property (nonatomic, readonly) NSString *name;
@property (nonatomic, readonly) NSString *namePron;
@property (nonatomic, readonly) NSString *nodeID;
@property (nonatomic, readonly) double nodeHeight;
@property (nonatomic, readonly) NSArray* nodeCoordinates;
@property (nonatomic, readonly) HLPLocation *nodeLocation;

- (NSString*) getLandmarkName;
- (NSString*) getLandmarkNamePron;
- (BOOL) isToilet;
- (BOOL) isFacility;
- (BOOL) isGround;
@end

HLPLocationObject （HLPObjectに位置情報がついた基底クラス）

@interface HLPLocationObject : HLPObject
@property (nonatomic, readonly) double lat;
@property (nonatomic, readonly) double lng;
@property (nonatomic, readonly) double height;
- (HLPLocation*) location;
@end

HLPNode （MapEditorの点）

@interface HLPNode : HLPLocationObject
@property (nonatomic, readonly) NSArray<NSString*> *connectedLinkIDs;

- (BOOL) isLeaf;
@end

リンクの方向性

typedef enum: int {
    DIRECTION_TYPE_BOTH = 0,
    DIRECTION_TYPE_SOURCE_TO_TARGET = 1,
    DIRECTION_TYPE_TARGET_TO_SOURCE = 2,
    DIRECTION_TYPE_UNKNOWN = 9
} HLPDirectionType;

点字ブロックタイプ

typedef NS_ENUM(NSInteger, HLPBrailleBlockType) {
    HLPBrailleBlockTypeNone = 0,
    HLPBrailleBlockTypeAvailable = 1,
    HLPBrailleBlockTypeUnknown = 9
};

リンクタイプ

typedef enum: int {
    LINK_TYPE_SIDEWALK = 1,
    LINK_TYPE_PEDESTRIAN_ROAD = 2,
    LINK_TYPE_GARDEN_WALK = 3,
    LINK_TYPE_ROAD_WITHOUT_SIDEWALK = 4,
    LINK_TYPE_CROSSING = 5,
    LINK_TYPE_CROSSING_WITHOUT_SIGN = 6,
    LINK_TYPE_PEDESTRIAN_CONVEYER = 7,
    LINK_TYPE_FREE_WALKWAY = 8,
    LINK_TYPE_RAIL_CROSSING = 9,
    LINK_TYPE_ELEVATOR = 10,
    LINK_TYPE_ESCALATOR = 11,
    LINK_TYPE_STAIRWAY = 12,
    LINK_TYPE_RAMP = 13,
    
    LINK_TYPE_UNKNOWN = 99
} HLPLinkType;
// 1：歩道、2：歩行者専用道路、3：園路、4：歩車共存道路、5：横断歩道、
// 6：横断歩道の路面標示の無い交差点の道路、7：動く歩道、8：自由通路、
// 9：踏切、10：エレベーター、11：エスカレーター、12：階段、13：スロープ、99：不明

POIのフラグ

@interface HLPPOIFlags: NSObject <NSCoding>
- (instancetype)initWithString:(NSString *)str;
@property (nonatomic, readonly) BOOL flagCaution;
@property (nonatomic, readonly) BOOL flagOnomastic;
@property (nonatomic, readonly) BOOL flagSingular;
@property (nonatomic, readonly) BOOL flagPlural;
@property (nonatomic, readonly) BOOL flagAuto;
@property (nonatomic, readonly) BOOL flagWelcome;
@end

エレベーター内設備POIのフラグ

@interface HLPPOIElevatorEquipments: HLPPOIFlags
@property (nonatomic, readonly) BOOL buttonLeft;
@property (nonatomic, readonly) BOOL buttonLeftBraille;
@property (nonatomic, readonly) BOOL buttonRight;
@property (nonatomic, readonly) BOOL buttonRightBraille;
@property (nonatomic, readonly) BOOL voiceGuide;
@property (nonatomic, readonly) BOOL buttonWcLeft;
@property (nonatomic, readonly) BOOL buttonWcLeftBraille;
@property (nonatomic, readonly) BOOL buttonWcRight;
@property (nonatomic, readonly) BOOL buttonWcRightBraille;
@end

エレベーター呼び出しボタンPOIのフラグ

@interface HLPPOIElevatorButtons: HLPPOIFlags
@property (nonatomic, readonly) BOOL buttonLeft;
@property (nonatomic, readonly) BOOL buttonLeftBraille;
@property (nonatomic, readonly) BOOL buttonRight;
@property (nonatomic, readonly) BOOL buttonRightBraille;
@property (nonatomic, readonly) BOOL buttonMiddle;
@property (nonatomic, readonly) BOOL buttonMiddleBraille;
@property (nonatomic, readonly) BOOL flagLower;
@end

エスカレーターPOIのフラグ（MapEditorでは編集しない）

@interface HLPPOIEscalatorFlags: HLPPOIFlags
@property (nonatomic, readonly) BOOL upward;
@property (nonatomic, readonly) BOOL downward;
@property (nonatomic, readonly) BOOL forward;
@property (nonatomic, readonly) BOOL backward;
@property (nonatomic, readonly) BOOL left;
@property (nonatomic, readonly) BOOL right;
@end

HLPLink （MapEditorの線）

@interface HLPLink : HLPObject {
@protected
    double _length;
    HLPDirectionType _direction;
    NSString *_sourceNodeID;
    double _sourceHeight;
    NSString *_targetNodeID;
    double _targetHeight;
    HLPLinkType _linkType;
    BOOL _backward;
    HLPLocation *sourceLocation;
    HLPLocation *targetLocation;
    double _minimumWidth;
    HLPPOIElevatorEquipments *elevatorEquipments;
    HLPBrailleBlockType _brailleBlockType;
    NSArray<HLPPOIEscalatorFlags*>* _escalatorFlags;
    NSString* _streetName;
}

@property (nonatomic, readonly) double length;
@property (nonatomic, readonly) HLPDirectionType direction;
@property (nonatomic, readonly) NSString *sourceNodeID;
@property (nonatomic, readonly) double sourceHeight;
@property (nonatomic, readonly) NSString *targetNodeID;
@property (nonatomic, readonly) double targetHeight;
@property (nonatomic, readonly) HLPLinkType linkType;
@property (nonatomic, readonly) BOOL backward;
@property (nonatomic, readonly) double minimumWidth;
@property (nonatomic, readonly) HLPBrailleBlockType brailleBlockType;
@property (nonatomic, readonly) BOOL isLeaf;
@property NSArray<HLPPOIEscalatorFlags*>* escalatorFlags;
@property (nonatomic, readonly) HLPNode *sourceNode;
@property (nonatomic, readonly) HLPNode *targetNode;
@property (nonatomic, readonly) NSString *streetName;
@property (nonatomic) BOOL isCrossingCorridor;

+ (NSString*) nameOfLinkType:(HLPLinkType)type;
- (double) initialBearingFromSource;
- (double) lastBearingForTarget;
- (double) initialBearingFromTarget;
- (double) lastBearingForSource;
- (double) initialBearingFrom:(HLPNode*)node;
- (double) bearingAtLocation:(HLPLocation*)loc;
- (void) updateLastBearingForTarget:(double)bearing;
- (HLPLocation*) sourceLocation;
- (HLPLocation*) targetLocation;
- (HLPLocation*) locationDistanceToTarget:(double) distance;
- (void) updateWithNodesMap:(NSDictionary*)nodesMap;
- (void) setTargetNodeIfNeeded:(HLPNode*)node withNodesMap:(NSDictionary*)nodesMap;
- (void) offsetTarget:(double)distance;
- (void) offsetSource:(double)distance;
- (HLPPOIElevatorEquipments*) elevatorEquipments;
- (BOOL) isSafeLinkType;

- (instancetype) initWithSource:(HLPLocation*)source Target:(HLPLocation*)target;
@end

HLPCombinedLink HLPLinkを複数結合したリンク

@interface HLPCombinedLink : HLPLink

@property (nonatomic, readonly) NSArray* links;
+(BOOL) link:(HLPLink*)link1 shouldBeCombinedWithLink:(HLPLink*)link2;
+(BOOL) link:(HLPLink*)link1 canBeCombinedWithLink:(HLPLink*)link2;
-(instancetype) initWithLink1:(HLPLink*)link1 andLink2:(HLPLink*) link2;

@end

HLPFacility （施設情報

@interface HLPFacility : HLPLocationObject
@property (nonatomic, readonly) NSString *name;
@property (nonatomic, readonly) NSString *namePron;
@property (nonatomic, readonly) NSString *longDescription;
@property (nonatomic, readonly) NSString *longDescriptionPron;
@property (nonatomic, readonly) NSString *lang;
@property (nonatomic, readonly) NSString *addr;
@property (nonatomic, readonly) NSArray *entrances;

- (BOOL)isNotRead;

@end

POIのカテゴリー

typedef NS_ENUM(NSInteger, HLPPOICategory) {
    HLPPOICategoryInfo=0,
    HLPPOICategoryFloor,
    HLPPOICategoryCornerEnd,
    HLPPOICategoryCornerWarningBlock,
    HLPPOICategoryCornerLandmark,
    HLPPOICategoryElevator,
    HLPPOICategoryElevatorEquipments,
    HLPPOICategoryDoor,
    HLPPOICategoryObstacle,
    HLPPOICategoryCOUNT
};

POIのカテゴリーの文字列

static const char* HLPPOICategoryStrings[] = {
    "_nav_info_",
    "_nav_floor_",
    "_nav_corner_end_",
    "_nav_corner_warning_block_",
    "_nav_corner_landmark_",
    "_nav_elevator_",
    "_nav_elevator_equipments_",
    "_nav_door_",
    "_nav_obstacle_"
};

HLPPOI （施設情報の拡張、major_category="_nav_poi_"）

@interface HLPPOI : HLPFacility
@property (nonatomic, readonly) NSString* majorCategory;
@property (nonatomic, readonly) NSString* subCategory;
@property (nonatomic, readonly) NSString* minorCategory;
@property (nonatomic, readonly) double heading;
@property (nonatomic, readonly) double angle;
@property (nonatomic, readonly) HLPPOICategory poiCategory;
@property (nonatomic, readonly) HLPPOIFlags* flags;
@property (nonatomic, readonly) HLPPOIElevatorButtons *elevatorButtons;
@property (nonatomic, readonly) HLPPOIElevatorEquipments *elevatorEquipments;
- (BOOL) allowsNoFloor;
- (NSString*) poiCategoryString;
- (BOOL) isOnFront:(HLPLocation*)location;
- (BOOL) isOnSide:(HLPLocation*)location;
@end

HLPEntrance （入り口情報）

@interface HLPEntrance : HLPLocationObject
@property (nonatomic, readonly) NSString *forNodeID;
@property (nonatomic, readonly) NSString *forFacilityID;
@property (nonatomic, readonly) NSString *name;
@property (nonatomic, readonly) NSString *namePron;
@property (nonatomic, readonly) HLPNode *node;
@property (nonatomic, readonly) HLPFacility *facility;
@property (nonatomic, readonly) NSString *lang;
- (void) updateNode:(HLPNode*) node andFacility:(HLPFacility*) facility;
- (NSString*) getName;
- (NSString*) getNamePron;
- (NSString*) getLongDescription;
- (NSString*) getLongDescriptionPron;
@end