ActiveRecord PostGIS 适配器使用教程

ActiveRecord PostGIS 适配器使用教程

activerecord-postgis-adapter ActiveRecord connection adapter for PostGIS, based on postgresql and rgeo 项目地址: https://gitcode.com/gh_mirrors/ac/activerecord-postgis-adapter

1. 项目介绍

ActiveRecord PostGIS 适配器是一个开源项目，它允许开发者通过ActiveRecord来访问PostGIS地理空间数据库的功能。PostGIS是一个扩展了PostgreSQL数据库的扩展模块，提供了对地理空间数据的支持。这个适配器使得在Ruby on Rails应用程序中处理空间数据变得简单。

2. 项目快速启动

安装PostGIS

首先，确保你的系统中已经安装了PostgreSQL和PostGIS。以下是安装PostGIS的常见方法：

• MacOS: brew install postgis
• Ubuntu/Debian: sudo apt-get install postgis postgresql-16-postgis-3
• Windows: PostGIS可能作为PostgreSQL安装程序的一个可选包提供。如果没有，请参考安装指南。

添加到Gemfile

在你的Rails项目的Gemfile中添加以下代码：

gem 'activerecord-postgis-adapter'

然后执行bundle install来安装依赖。

配置database.yml

修改你的config/database.yml文件，将adapter字段从postgresql更改为postgis。以下是一个推荐的配置示例：

default: &default
  adapter: postgis
  encoding: unicode
  pool: 5
  # 其他配置...

development:
  <<: *default
  database: my_app_development
  username: my_app_user
  password: my_app_password
  # 如果你的PostGIS扩展安装在了非public schema，需要指定
  schema_search_path: public,postgis

创建数据库和迁移

创建数据库：

rake db:create

创建一个迁移来添加PostGIS扩展到你的数据库：

rails generate migration AddPostgisExtensionToDatabase

迁移文件应该看起来像这样：

class AddPostgisExtensionToDatabase < ActiveRecord::Migration[7.2]
  def change
    enable_extension 'postgis'
  end
end

运行迁移：

rails db:migrate

3. 应用案例和最佳实践

创建空间表

要存储空间数据，你需要创建一个带有空间类型的列。以下是一个示例，它在表中创建了五个空间列：

create_table :my_spatial_table do |t|
  t.column :shape1, :geometry
  t.geometry :shape2
  t.line_string :path, srid: 3785
  t.st_point :lonlat, geographic: true
  t.st_point :lonlatheight, geographic: true, has_z: true
end

查询空间数据

你可以使用WKT格式数据或RGeo对象在查询中嵌入简单的空间数据。例如：

Model.where("column_name ST_Intersects ST_SetSRID(ST_Point(1, 1), 4326)")

4. 典型生态项目

目前，ActiveRecord PostGIS适配器是处理Rails应用中空间数据的一个典型解决方案。它与其他多个开源项目协同工作，例如：

• RGeo: 一个用于处理空间数据的Ruby库。
• GeoRuby: 另一个Ruby库，提供对PostGIS的支持。
• Spatialite: 一个SQLite扩展，提供对空间数据的支持。

这些项目共同构成了Ruby空间数据处理的开源生态系统。

activerecord-postgis-adapter ActiveRecord connection adapter for PostGIS, based on postgresql and rgeo 项目地址: https://gitcode.com/gh_mirrors/ac/activerecord-postgis-adapter