Geo.Polygon(lineStrings: GeoLineString[]): GeoPolygon

支持端:小程序 2.6.3 起, 云函数

构造一个地理位置 ”多边形“

参数

lineStrings: GeoLineString[]

“线” 数组

返回值

GeoPolygon

索引

如存储地理位置信息的字段有被查询的需求,务必对字段建立地理位置索引

说明

一个多边形由一个或多个线性环(Linear Ring)组成,一个线性环即一个闭合的线段。一个闭合线段至少由四个点组成,其中最后一个点和第一个点的坐标必须相同,以此表示环的起点和终点。如果一个多边形由多个线性环组成,则第一个线性环表示外环(外边界),接下来的所有线性环表示内环(即外环中的洞,不计在此多边形中的区域)。如果一个多边形只有一个线性环组成,则这个环就是外环。

多边形构造规则:

  • 第一个线性环必须是外环
  • 外环不能自交
  • 所有内环必须完全在外环内
  • 各个内环间不能相交或重叠,也不能有共同的边
  • 外环应为逆时针,内环应为顺时针

示例代码

示例代码:单环多边形

  1. const { Polygon, LineString, Point } = db.Geo
  2. db.collection('todos').add({
  3. data: {
  4. description: 'eat an apple',
  5. location: Polygon([
  6. LineString([
  7. Point(0, 0),
  8. Point(3, 2),
  9. Point(2, 3),
  10. Point(0, 0)
  11. ])
  12. ])
  13. }
  14. }).then(console.log).catch(console.error)

示例代码:含一个外环和一个内环的多边形

  1. const { Polygon, LineString, Point } = db.Geo
  2. db.collection('todos').add({
  3. data: {
  4. description: 'eat an apple',
  5. location: Polygon([
  6. // 外环
  7. LineString([ Point(0, 0), Point(30, 20), Point(20, 30), Point(0, 0) ]),
  8. // 内环
  9. LineString([ Point(10, 10), Point(16, 14), Point(14, 16), Point(10, 10) ])
  10. ])
  11. }
  12. }).then(console.log).catch(console.error)

除了使用接口构造一个 Polygon 外,也可以使用等价的 GeoJSON多边形 (Polygon) 的 JSON 表示,其格式如下:

  1. {
  2. "type": "Polygon",
  3. "coordinates": [
  4. [ [lng, lat], [lng, lat], [lng, lat], ..., [lng, lat] ], // 外环
  5. [ [lng, lat], [lng, lat], [lng, lat], ..., [lng, lat] ], // 可选内环 1
  6. ...
  7. [ [lng, lat], [lng, lat], [lng, lat], ..., [lng, lat] ], // 可选内环 n
  8. ]
  9. }

示例代码

  1. db.collection('todos').add({
  2. data: {
  3. description: 'eat an apple',
  4. location: {
  5. type: 'Polygon',
  6. coordinates: [
  7. [ [0, 0], [30, 20], [20, 30], [0, 0] ],
  8. [ [10, 10], [16, 14], [14, 16], [10, 10]]
  9. ]
  10. }
  11. }
  12. }).then(console.log).catch(console.error)