geo-types-cz 1.0.0

package/src/extensions.ts

@@ -0,0 +1,231 @@
+/**
+ * 扩展的GIS类型定义
+ * 包括样式、符号化、图层等前端GIS开发中常用的类型
+ */
+
+import { Feature, FeatureCollection, FeatureType, Properties } from './feature';
+import { Geometry } from './geometry';
+
+// 颜色类型
+export type Color = string; // CSS颜色值，如 '#ff0000', 'red', 'rgb(255,0,0)'
+
+// 样式类型
+export interface Style {
+  // 填充样式
+  fill?: {
+    color?: Color;
+    opacity?: number;
+  };
+  
+  // 描边样式
+  stroke?: {
+    color?: Color;
+    width?: number;
+    opacity?: number;
+    dashArray?: number[];
+    lineCap?: 'butt' | 'round' | 'square';
+    lineJoin?: 'miter' | 'round' | 'bevel';
+  };
+  
+  // 点样式
+  marker?: {
+    size?: number;
+    color?: Color;
+    opacity?: number;
+    symbol?: 'circle' | 'square' | 'triangle' | 'star' | 'cross' | 'diamond';
+  };
+  
+  // 文本样式
+  text?: {
+    field?: string; // 属性字段名
+    font?: string;
+    size?: number;
+    color?: Color;
+    haloColor?: Color;
+    haloWidth?: number;
+    offset?: [number, number];
+    anchor?: 'start' | 'middle' | 'end';
+    baseline?: 'top' | 'middle' | 'bottom';
+  };
+}
+
+// 带样式的要素
+export interface StyledFeature<G extends Geometry = Geometry, P extends Properties = Properties> extends Feature<G, P> {
+  style?: Style;
+}
+
+// 带样式的要素集合
+export interface StyledFeatureCollection<G extends Geometry = Geometry, P extends Properties = Properties> {
+  type: FeatureType.FeatureCollection;
+  features: StyledFeature<G, P>[];
+  style?: Style; // 默认样式
+  bbox?: [number, number, number, number] | [number, number, number, number, number, number];
+}
+
+// 图层类型
+export enum LayerType {
+  Vector = 'vector',
+  Raster = 'raster',
+  TileLayer = 'tile'
+}
+
+// 基础图层接口
+export interface BaseLayer {
+  id: string;
+  name: string;
+  type: LayerType;
+  visible?: boolean;
+  opacity?: number;
+  minZoom?: number;
+  maxZoom?: number;
+  metadata?: { [key: string]: any };
+}
+
+// 矢量图层
+export interface VectorLayer extends BaseLayer {
+  type: LayerType.Vector;
+  data: FeatureCollection | StyledFeatureCollection;
+  style?: Style;
+}
+
+// 栅格图层
+export interface RasterLayer extends BaseLayer {
+  type: LayerType.Raster;
+  url: string;
+  bounds?: [number, number, number, number];
+}
+
+// 瓦片图层
+export interface TileLayer extends BaseLayer {
+  type: LayerType.TileLayer;
+  url: string; // 瓦片URL模板，如 'https://tile.openstreetmap.org/{z}/{x}/{y}.png'
+  attribution?: string;
+  subdomains?: string[];
+}
+
+// 图层联合类型
+export type Layer = VectorLayer | RasterLayer | TileLayer;
+
+// 地图视图配置
+export interface MapView {
+  center: [number, number]; // [longitude, latitude]
+  zoom: number;
+  bearing?: number; // 地图旋转角度
+  pitch?: number; // 地图倾斜角度
+  bounds?: [number, number, number, number]; // [west, south, east, north]
+}
+// 点聚类配置。
+ export interface ClusterConfig {
+  enabled: boolean
+  distance: number
+  maxZoom: number
+  minPoints?: number
+  style?: {
+    cluster?: Style
+    clusterText?: {
+    font?: string
+    size?: number
+    color?: string
+    haloColor?: string
+    haloWidth?: number
+  }
+  }
+}
+
+// 地图配置
+export interface MapConfig {
+  container: string | any; // DOM Element or string selector
+  view: MapView;
+  layers?: Layer[];
+  controls?: {
+    zoom?: boolean;
+    attribution?: boolean;
+    scale?: boolean;
+    fullscreen?: boolean;
+  };
+  interactions?: {
+    dragPan?: boolean;
+    scrollZoom?: boolean;
+    doubleClickZoom?: boolean;
+    keyboard?: boolean;
+  };
+}
+
+// 空间查询类型
+export enum SpatialQueryType {
+  Intersects = 'intersects',
+  Contains = 'contains',
+  Within = 'within',
+  Touches = 'touches',
+  Crosses = 'crosses',
+  Overlaps = 'overlaps'
+}
+
+// 空间查询接口
+export interface SpatialQuery {
+  type: SpatialQueryType;
+  geometry: Geometry;
+  buffer?: number; // 缓冲区距离
+}
+
+// 属性查询接口
+export interface AttributeQuery {
+  field: string;
+  operator: '=' | '!=' | '>' | '<' | '>=' | '<=' | 'like' | 'in' | 'not in';
+  value: any;
+}
+
+// 复合查询接口
+export interface Query {
+  spatial?: SpatialQuery;
+  attributes?: AttributeQuery[];
+  logic?: 'and' | 'or';
+}
+
+// 类型守卫函数
+export function isVectorLayer(layer: Layer): layer is VectorLayer {
+  return layer.type === LayerType.Vector;
+}
+
+export function isRasterLayer(layer: Layer): layer is RasterLayer {
+  return layer.type === LayerType.Raster;
+}
+
+export function isTileLayer(layer: Layer): layer is TileLayer {
+  return layer.type === LayerType.TileLayer;
+}
+
+// 工具函数
+export function createVectorLayer(
+  id: string,
+  name: string,
+  data: FeatureCollection,
+  style?: Style
+): VectorLayer {
+  return {
+    id,
+    name,
+    type: LayerType.Vector,
+    data,
+    style,
+    visible: true,
+    opacity: 1
+  };
+}
+
+export function createTileLayer(
+  id: string,
+  name: string,
+  url: string,
+  attribution?: string
+): TileLayer {
+  return {
+    id,
+    name,
+    type: LayerType.TileLayer,
+    url,
+    attribution,
+    visible: true,
+    opacity: 1
+  };
+}

package/src/feature.ts

@@ -0,0 +1,70 @@
+/**
+ * GeoJSON要素类型定义
+ */
+
+import { Geometry } from './geometry';
+
+// 要素类型枚举
+export enum FeatureType {
+  Feature = 'Feature',
+  FeatureCollection = 'FeatureCollection'
+}
+
+// 属性类型 - 可以是任意JSON值
+export type Properties = { [key: string]: any } | null;
+
+// 要素接口
+export interface Feature<G extends Geometry = Geometry, P extends Properties = Properties> {
+  type: FeatureType.Feature;
+  geometry: G | null;
+  properties: P;
+  id?: string | number;
+  bbox?: [number, number, number, number] | [number, number, number, number, number, number];
+}
+
+// 要素集合接口
+export interface FeatureCollection<G extends Geometry = Geometry, P extends Properties = Properties> {
+  type: FeatureType.FeatureCollection;
+  features: Feature<G, P>[];
+  bbox?: [number, number, number, number] | [number, number, number, number, number, number];
+}
+
+// GeoJSON对象联合类型
+export type GeoJSONObject = Geometry | Feature | FeatureCollection;
+
+// 类型守卫函数
+export function isFeature(obj: GeoJSONObject): obj is Feature {
+  return obj.type === FeatureType.Feature;
+}
+
+export function isFeatureCollection(obj: GeoJSONObject): obj is FeatureCollection {
+  return obj.type === FeatureType.FeatureCollection;
+}
+
+// 工具函数
+export function createFeature<G extends Geometry, P extends Properties>(
+  geometry: G | null,
+  properties: P,
+  id?: string | number
+): Feature<G, P> {
+  const feature: Feature<G, P> = {
+    type: FeatureType.Feature,
+    geometry,
+    properties
+  };
+  
+  if (id !== undefined) {
+    feature.id = id;
+  }
+  
+  return feature;
+}
+
+export function createFeatureCollection<G extends Geometry, P extends Properties>(
+  features: Feature<G, P>[]
+): FeatureCollection<G, P> {
+  return {
+    type: FeatureType.FeatureCollection,
+    features
+  };
+}

package/src/geometry.ts

@@ -0,0 +1,138 @@
+/**
+ * GeoJSON几何类型定义
+ * 基于RFC 7946标准
+ */
+
+import { isFeature } from "./feature";
+
+// 基础位置类型
+export type Position = [number, number] | [number, number, number];
+
+// 几何类型枚举
+export enum GeometryType {
+  Point = 'Point',
+  LineString = 'LineString',
+  Polygon = 'Polygon',
+  MultiPoint = 'MultiPoint',
+  MultiLineString = 'MultiLineString',
+  MultiPolygon = 'MultiPolygon',
+  GeometryCollection = 'GeometryCollection'
+}
+
+// 基础几何接口
+export interface BaseGeometry {
+  type: GeometryType;
+  bbox?: [number, number, number, number] | [number, number, number, number, number, number];
+}
+
+// 点几何
+export interface Point extends BaseGeometry {
+  type: GeometryType.Point;
+  coordinates: Position;
+}
+
+// 线几何
+export interface LineString extends BaseGeometry {
+  type: GeometryType.LineString;
+  coordinates: Position[];
+}
+
+// 多边形几何
+export interface Polygon extends BaseGeometry {
+  type: GeometryType.Polygon;
+  coordinates: Position[][];
+}
+
+// 多点几何
+export interface MultiPoint extends BaseGeometry {
+  type: GeometryType.MultiPoint;
+  coordinates: Position[];
+}
+
+// 多线几何
+export interface MultiLineString extends BaseGeometry {
+  type: GeometryType.MultiLineString;
+  coordinates: Position[][];
+}
+
+// 多多边形几何
+export interface MultiPolygon extends BaseGeometry {
+  type: GeometryType.MultiPolygon;
+  coordinates: Position[][][];
+}
+
+// 几何集合
+export interface GeometryCollection extends BaseGeometry {
+  type: GeometryType.GeometryCollection;
+  geometries: Geometry[];
+}
+
+// 联合几何类型
+export type Geometry = 
+  | Point 
+  | LineString 
+  | Polygon 
+  | MultiPoint 
+  | MultiLineString 
+  | MultiPolygon 
+  | GeometryCollection;
+
+// 几何类型守卫函数
+export function isPoint(geometry: Geometry): geometry is Point {
+  return geometry.type === GeometryType.Point;
+}
+
+export function isLineString(geometry: Geometry): geometry is LineString {
+  return geometry.type === GeometryType.LineString;
+}
+
+export function isPolygon(geometry: Geometry): geometry is Polygon {
+  return geometry.type === GeometryType.Polygon;
+}
+
+export function isMultiPoint(geometry: Geometry): geometry is MultiPoint {
+  return geometry.type === GeometryType.MultiPoint;
+}
+
+export function isMultiLineString(geometry: Geometry): geometry is MultiLineString {
+  return geometry.type === GeometryType.MultiLineString;
+}
+
+export function isMultiPolygon(geometry: Geometry): geometry is MultiPolygon {
+  return geometry.type === GeometryType.MultiPolygon;
+}
+
+export function isGeometryCollection(geometry: Geometry): geometry is GeometryCollection {
+  return geometry.type === GeometryType.GeometryCollection;
+}
+
+
+// 经纬度校验
+export function validateCoordinates(coordinates: readonly [number, number]): boolean {
+  const [lon, lat] = coordinates
+  return lon >= -180 && lon <= 180 && lat >= -90 && lat <= 90
+}
+
+//集合体验证
+export function validateGeometry(geometry: any): boolean {
+  if (!geometry || !geometry.type) return false
+  
+  switch (geometry.type) {
+    case 'Point':
+      return isPoint(geometry) && validateCoordinates(geometry.coordinates as [number, number])
+    case 'LineString':
+      return isLineString(geometry) && 
+             geometry.coordinates.every((coord: any) => validateCoordinates(coord))
+    case 'Polygon':
+      return isPolygon(geometry) && 
+             geometry.coordinates.every((ring: any) => 
+               ring.every((coord: any) => validateCoordinates(coord))
+             )
+    default:
+      return false
+  }
+}
+// 验证要素的几何体
+export function validateFeatureGeometry(feature: any): boolean {
+  return isFeature(feature) && validateGeometry(feature.geometry)
+}

package/src/index.ts

@@ -0,0 +1,156 @@
+/**
+ * geo-types-cz
+ * Complete TypeScript type definitions for GeoJSON and extended GIS types
+ * 
+ * 这个包提供了完整的GeoJSON类型定义以及扩展的GIS类型，
+ * 适用于前端地理信息系统开发。
+ */
+
+// 导出几何类型
+export {
+  Position,
+  GeometryType,
+  BaseGeometry,
+  Point,
+  LineString,
+  Polygon,
+  MultiPoint,
+  MultiLineString,
+  MultiPolygon,
+  GeometryCollection,
+  Geometry,
+  isPoint,
+  isLineString,
+  isPolygon,
+  isMultiPoint,
+  isMultiLineString,
+  isMultiPolygon,
+  isGeometryCollection,
+  validateCoordinates,
+  validateFeatureGeometry
+} from './geometry';
+
+// 导出要素类型
+export {
+  FeatureType,
+  Properties,
+  Feature,
+  FeatureCollection,
+  GeoJSONObject,
+  isFeature,
+  isFeatureCollection,
+  createFeature,
+  createFeatureCollection
+} from './feature';
+
+// 导出坐标参考系统类型
+export {
+  CRSType,
+  BaseCRS,
+  NamedCRS,
+  LinkedCRS,
+  CRS,
+  CommonCRS,
+  isNamedCRS,
+  isLinkedCRS,
+  createNamedCRS,
+  createLinkedCRS
+} from './crs';
+
+// 导出边界框类型
+export {
+  BBox2D,
+  BBox3D,
+  BBox,
+  BoundingBox,
+  is2DBBox,
+  is3DBBox,
+  createBBox2D,
+  createBBox3D,
+  bboxToObject,
+  objectToBBox,
+  unionBBox,
+  isPositionInBBox,
+  getBBoxCenter
+} from './bbox';
+
+// 导出扩展类型
+export {
+  Color,
+  Style,
+  StyledFeature,
+  StyledFeatureCollection,
+  LayerType,
+  BaseLayer,
+  VectorLayer,
+  RasterLayer,
+  TileLayer,
+  Layer,
+  MapView,
+  MapConfig,
+  SpatialQueryType,
+  SpatialQuery,
+  AttributeQuery,
+  Query,
+  isVectorLayer,
+  isRasterLayer,
+  isTileLayer,
+  ClusterConfig
+} from './extensions';
+
+// 导出工具函数
+export {
+  degreesToRadians,
+  radiansToDegrees,
+  calculateDistance,
+  calculateBearing,
+  calculateDestination,
+  calculateLineLength,
+  calculatePolygonArea,
+  calculateGeometryBBox,
+  calculateFeatureCollectionBBox,
+  simplifyLineString,
+  createBuffer
+} from './utils';
+
+// 版本信息
+export const VERSION = '1.0.0';
+
+// 默认导出
+export default {
+  VERSION
+};
+
+/**
+ * 使用示例：
+ * 
+ * ```typescript
+ * import { 
+ *   Point, 
+ *   Feature, 
+ *   FeatureCollection, 
+ *   createFeature, 
+ *   calculateDistance 
+ * } from 'geo-types-cz';
+ * 
+ * // 创建点几何
+ * const point: Point = {
+ *   type: 'Point',
+ *   coordinates: [116.3974, 39.9093] // 北京天安门
+ * };
+ * 
+ * // 创建要素
+ * const feature = createFeature(point, {
+ *   name: '天安门',
+ *   city: '北京'
+ * });
+ * 
+ * // 计算两点间距离
+ * const distance = calculateDistance(
+ *   [116.3974, 39.9093], // 天安门
+ *   [121.4737, 31.2304]  // 上海外滩
+ * );
+ * 
+ * console.log(`北京到上海的距离: ${Math.round(distance / 1000)}公里`);
+ * ```
+ */