dataorganizer.java

openmap java写的开源数字地图程序. 用applet实现,可以像google map 那样放大缩小地图.

// **********************************************************************
// 
// <copyright>
// 
//  BBN Technologies
//  10 Moulton Street
//  Cambridge, MA 02138
//  [phone]
// 
//  Copyright (C) BBNT Solutions LLC. All rights reserved.
// 
// </copyright>
// **********************************************************************
// 
// $Source: /cvs/distapps/openmap/src/openmap/com/bbn/openmap/util/DataOrganizer.java,v $
// $RCSfile: DataOrganizer.java,v $
// $Revision: 1.1.1.1.2.1 $
// $Date: 2004/10/14 18:27:46 $
// $Author: dietrick $
// 
// **********************************************************************

package com.bbn.openmap.util;

import java.util.Vector;

/**
 * The DataOrganizer lets you organize objects in a way that will let
 * you retrieve them based on a geographic query. It's an interface
 * that lets you decide, with an implementation, the best way to
 * manage and retrieve your data.
 */

public interface DataOrganizer {

    /**
     * Add a object into the organizer at a location.
     * 
     * @param lat up-down location (latitude, y)
     * @param lon left-right location (longitude, x)
     * @return true if the insertion worked.
     */
    public boolean put(float lat, float lon, Object obj);

    /**
     * Remove a object out of the organizer at a location.
     * 
     * @param lat up-down location (latitude, y)
     * @param lon left-right location (longitude, x)
     * @return the object removed, null if the object not found.
     */
    public Object remove(float lat, float lon, Object obj);

    /** Clear the organizer. */
    public void clear();

    /**
     * Find an object closest to a lat/lon.
     * 
     * @param lat up-down location in QuadTree Grid (latitude, y)
     * @param lon left-right location in QuadTree Grid (longitude, x)
     * @return the object that is closest to the lat/lon.
     */
    public Object get(float lat, float lon);

    /**
     * Find an object closest to a lat/lon, within a given maximum.
     * 
     * @param lat up-down location in QuadTree Grid (latitude, y)
     * @param lon left-right location in QuadTree Grid (longitude, x)
     * @param withinDistance maximum distance to have a hit.
     * @return the object that is closest to the lat/lon, within the
     *         given distance.
     */
    public Object get(float lat, float lon, double withinDistance);

    /**
     * Find all the objects within a bounding box.
     * 
     * @param north top location in QuadTree Grid (latitude, y)
     * @param west left location in QuadTree Grid (longitude, x)
     * @param south lower location in QuadTree Grid (latitude, y)
     * @param east right location in QuadTree Grid (longitude, x)
     * @return Vector of objects.
     */
    public Vector get(float north, float west, float south, float east);

}