The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....



AddCity


Unit:SDL_geodb
Class:TGeoDB
Declaration:function AddCity (Name: TgdbName; Polygon: TgdbPolygon; ClosedLine: boolean; Date: TDateTime; StateFlag: longint; LatLow, LatHigh, LongLow, LongHigh, Altitude: single; ClassNumber: byte; UserTag: longint): integer;

The method AddCity adds the coordinates of the outline of a city to the database. The parameter Name contains the name of the city. The outline is defined by a polygon which is passed via the parameter Polygon. The parameter ClosedLine determines whether the outline is a closed line. The parameter Date holds the date and time associated with the city. The parameter StateFlag reflects the state of the database entry. The parameters LatLow ... LongHigh specify the geographical area the city covers. The parameter Altitude defines the (average) altitude of the city data. ClassNumber contains the number of the class the new database entry should belong to, and the UserTag parameter may hold a user-defined number. UserTag is not used by the database system, it can be used to store additional information.

The function AddCity returns the database entry number of the newly created entry, or a value of -1 if an error occurred.

Hint: Please note the difference between a city and a town: while a city is large enough to be represented by an outline polygon, a town is represented by a single point.



Last Update: 2012-Oct-20