GeoRuby技术文档

1. 安装指南

安装GeoRuby的最新版本，只需在命令行中输入以下命令：

gem install georuby

或者在项目的Gemfile文件中包含以下内容：

gem 'georuby'

根据需要，您还可以选择性地引入以下模块：

require 'geo_ruby/ewk'        # EWKT/EWKB
require 'geo_ruby/shp'        # Shapefile
require 'geo_ruby/gpx'        # GPX数据
require 'geo_ruby/kml'        # KML数据
require 'geo_ruby/georss'     # GeoRSS
require 'geo_ruby/geojson'    # GeoJSON

2. 项目的使用说明

GeoRuby提供了多种几何数据类型，包括点、线、线性环、多边形、多点、多线、多边形集合以及几何集合。以下是一些简单的使用示例：

创建3D点

include GeoRuby::SimpleFeatures
Point.from_x_y_z(10.0, 20.0, 5.0)

创建线字符串

LineString.from_coordinates([[1,1],[2,2]],4326)

创建多边形

coordinates = [[0,0],[0,1],[1,1],[1,0]]
outer_ring = LinearRing.from_coordinates(coordinates, 4326)
rings = [outer_ring]
Polygon.from_linear_rings(rings)

判断点是否在多边形内

point = Point.from_x_y(0.5, 0.5)
polygon = Polygon.from_coordinates([[[0,0],[0,1],[1,1],[1,0]]],4326)
polygon.contains_point?(point)

3. 项目API使用文档

GeoRuby支持多种空间数据格式的输入和输出，包括WKB、EWKB、WKT、EWKT格式以及GeoRSS、KML、Shapefile、GPX和GeoJSON等。

以下是一些API使用示例：

输入和输出

# 将几何数据转换为WKT格式
point = Point.from_x_y(0.5, 0.5)
point.to_wkt

# 从WKT格式读取几何数据
wkt = "POINT(0.5 0.5)"
point = GeoRuby::SimpleFeatures::Geometry.from_wkt(wkt)

# 将几何数据转换为GeoJSON格式
point.to_json

Shapefile读写

# 读取Shapefile
require 'geo_ruby/shp'
GeoRuby::Shp4r::ShpFile.open('path_to_shapefile.shp') do |shp|
  shp.each do |shape|
    # 处理每个几何对象
  end
end

# 创建Shapefile
shpfile = GeoRuby::Shp4r::ShpFile.create('new_shapefile.shp', ShpType::POINT, [DBF::Field.new("name", "C", 10)])
shpfile.add(ShpRecord.new(Point.from_x_y(1.0, 1.0), 'name' => "Point1"))
shpfile.close

GPX读取

require 'geo_ruby/gpx'
gpxfile = GpxFile.open('path_to_gpx_file.gpx')
gpxfile.as_line_string

GeoJSON支持

# 从GeoJSON字符串解析几何数据
geojson_string = '{"type":"Point","coordinates":[100.0,0.0]}'
geometry = GeoRuby::SimpleFeatures::Geometry.from_geojson(geojson_string)

# 将几何数据转换为GeoJSON字符串
geojson_string = geometry.to_json

4. 项目安装方式

GeoRuby可以通过Ruby的包管理器gem进行安装，具体安装方式请参考安装指南部分的内容。确保在安装前已经安装了Ruby环境。