ควอดทรี

หน้านี้จะอธิบายถึงยูทิลิตี Quadtree ที่มีอยู่ใน ไลบรารียูทิลิตี Maps SDK สําหรับ iOS

รูปสี่เหลี่ยมเป็นโครงสร้างข้อมูลที่มีประโยชน์ต่อการหาจุดใกล้จุดเดี่ยว โดยการค้นหาภายในบริเวณรอบๆ จุดสนใจ

เมื่อใช้ต้นไม้สี่เหลี่ยม คุณสามารถค้นหาจุดที่อยู่ในช่วง 2 มิติได้อย่างมีประสิทธิภาพ โดยที่จุดเหล่านั้นถูกระบุเป็นพิกัดละติจูด/ลองจิจูดหรือรถเข็น (x, y) พิกัด ควอดทรีจัดเก็บที่เก็บข้อมูลพิกัดในโหนดและดัชนี ตามภูมิภาค (กรอบล้อมรอบ) หากต้องการค้นหาคู่พิกัดที่ต้องการ คุณจะข้ามผ่าน ผ่านโหนดของรูปสี่เหลี่ยม

สิ่งที่ต้องมีก่อนและหมายเหตุ

ยูทิลิตี Quadtree เป็นส่วนหนึ่งของ Maps SDK สำหรับ iOS ไลบรารียูทิลิตี หากยังไม่ได้ตั้งค่าไลบรารี ทำตามคู่มือการตั้งค่า ก่อนที่จะอ่านส่วนที่เหลือของหน้านี้

การเพิ่มต้นไม้สี่เหลี่ยมและค้นหาจุดในพื้นที่ที่กำหนด

โค้ดต่อไปนี้จะสร้างควอดทรี จากนั้นค้นหาจุดทั้งหมดภายใน พื้นที่ที่กำหนด:

Swift

import GoogleMapsUtils

class QuadTreeItem : NSObject, GQTPointQuadTreeItem {
  private let gqtPoint : GQTPoint

  init(point : GQTPoint) {
    self.gqtPoint = point
  }

  func point() -> GQTPoint {
    return gqtPoint
  }

  /// Function demonstrating how to create and use a quadtree
  private func test() {

    // Create a quadtree with bounds of [-2, -2] to [2, 2].
    let bounds = GQTBounds(minX: -2, minY: -2, maxX: 2, maxY: 2)
    guard let tree = GQTPointQuadTree(bounds: bounds) else {
      return
    }

    // Add 4 points to the tree.
    tree.add(QuadTreeItem(point: GQTPoint(x: -1, y: -1)))
    tree.add(QuadTreeItem(point: GQTPoint(x: -1, y: -1)))
    tree.add(QuadTreeItem(point: GQTPoint(x: -1, y: 1)))
    tree.add(QuadTreeItem(point: GQTPoint(x: 1, y: 1)))
    tree.add(QuadTreeItem(point: GQTPoint(x: 1, y: -1)))

    // Search for items within the rectangle with lower corner of (-1.5, -1.5)
    // and upper corner of (1.5, 1.5).
    let searchBounds = GQTBounds(minX: -1.5, minY: -1.5, maxX: 1.5, maxY: 1.5)
    for item in tree.search(with: searchBounds) as! [QuadTreeItem] {
      print("(\(item.point().x), \(item.point().y))");
    }
  }
}
      

Objective-C

@import GoogleMapsUtils;

@interface QuadTreeItem : NSObject<GQTPointQuadTreeItem>
- (instancetype)initWithPoint:(GQTPoint)point;
@end

@implementation QuadTreeItem {
  GQTPoint _point;
}

- (instancetype)initWithPoint:(GQTPoint)point {
  if ((self = [super init])) {
    _point = point;
  }
  return self;
}

- (GQTPoint)point {
  return _point;
}

/// Function demonstrating how to create and use a quadtree
- (void)test {
  // Create a quadtree with bounds of [-2, -2] to [2, 2].
  GQTBounds bounds = {-2, -2, 2, 2};
  GQTPointQuadTree *tree = [[GQTPointQuadTree alloc] initWithBounds:bounds];

  // Add 4 points to the tree.
  [tree add:[[QuadTreeItem alloc] initWithPoint:(GQTPoint){-1, -1}]];
  [tree add:[[QuadTreeItem alloc] initWithPoint:(GQTPoint){-1, 1}]];
  [tree add:[[QuadTreeItem alloc] initWithPoint:(GQTPoint){1, 1}]];
  [tree add:[[QuadTreeItem alloc] initWithPoint:(GQTPoint){1, -1}]];

  // Search for items within the rectangle with lower corner of (-1.5, -1.5)
  // and upper corner of (1.5, 1.5).
  NSArray *foundItems = [tree searchWithBounds:(GQTBounds){-1.5, -1.5, 1.5, 1.5}];

  for (QuadTreeItem *item in foundItems) {
    NSLog(@"(%lf, %lf)", item.point.x, item.point.y);
  }
}

@end