gazetteer.java

来自「world wind java sdk 源码」· Java 代码 · 共 33 行

/*
Copyright (C) 2001, 2008 United States Government
as represented by the Administrator of the
National Aeronautics and Space Administration.
All Rights Reserved.
*/

package gov.nasa.worldwind.poi;

import gov.nasa.worldwind.WWObject;
import gov.nasa.worldwind.exception.*;

import java.util.List;

/**
 * Interface to gazetteers.
 *
 * @author tag
 * @version $Id: Gazetteer.java 8393 2009-01-10 05:36:05Z tgaskins $
 */
public interface Gazetteer extends WWObject
{
    /**
     * Find places identified in a string of free text.
     *
     * @param placeInfo a string containing the place description.
     * @return the points-of-interest that match the place description.
     * @throws NoItemException  if the place description cannot be matched.
     * @throws ServiceException if the lookup service is not available or invocation of it fails.
     */
    public List<PointOfInterest> findPlaces(String placeInfo) throws NoItemException, ServiceException;
}