https://github.com/tomi77/protobuf-gis
https://github.com/tomi77/protobuf-gis
gis google-protocol-buffers linestring point polygon protocol-buffer
Last synced: 24 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/tomi77/protobuf-gis
- Owner: tomi77
- License: mit
- Created: 2017-08-02T07:10:44.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-08-21T19:23:01.000Z (almost 8 years ago)
- Last Synced: 2025-04-14T12:54:07.783Z (about 1 month ago)
- Topics: gis, google-protocol-buffers, linestring, point, polygon, protocol-buffer
- Language: Go
- Size: 73.2 KB
- Stars: 7
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# protobuf-gis
[](https://travis-ci.org/tomi77/protobuf-gis)
### Optional global installation
Clone repo
~~~sh
git clone https://github.com/tomi77/protobuf-gis.git
cd protobuf-gis
~~~Set up an m4 environment
~~~sh
aclocal
~~~Generate configure from configure.ac
~~~sh
autoconf
~~~Generate Makefile.in from Makefile.am
~~~sh
automake --add-missing
~~~Generate Makefile from Makefile.in
~~~sh
./configure
~~~Install files
~~~sh
make install
~~~## Messages
### Point
~~~
syntax = "proto3";import "gis/protobuf/point.proto";
package test;
message Test {
gis.protobuf.Point2D point2d = 1;
gis.protobuf.Point3D point3d = 2;
gis.protobuf.MultiPoint2D multi_point2d = 3;
gis.protobuf.MultiPoint3D multi_point3d = 4;
}
~~~#### Point2D
Structure with two fields of type `float`: `x` and `y`.
GeoJSON representation of this message is
~~~js
{
'type': 'Point',
'coordinates': [x, y]
}
~~~#### Point3D
Structure with three fields of type `float`: `x`, `y` and `z`.
GeoJSON representation of this message is
~~~js
{
'type': 'Point',
'coordinates': [x, y, z]
}
~~~#### MultiPoint2D
Structure with one repeated field of type `gis.protobuf.Point2D`: `point`.
GeoJSON representation of this message is
~~~js
{
'type': 'MultiPoint',
'coordinates': [[x1, y1], [x2, y2]]
}
~~~#### MultiPoint3D
Structure with one repeated field of type `gis.protobuf.Point3D`: `point`.
GeoJSON representation of this message is
~~~js
{
'type': 'MultiPoint',
'coordinates': [[x1, y1, z1], [x2, y2, z2]]
}
~~~### LineString
~~~
syntax = "proto3";import "gis/protobuf/linestring.proto";
package test;
message Test {
gis.protobuf.LineString2D line_string2d = 1;
gis.protobuf.LineString3D line_string3d = 2;
gis.protobuf.MultiLineString2D multi_line_string2d = 3;
gis.protobuf.MultiLineString3D multi_line_string3d = 4;
}
~~~#### LineString2D
Structure with one repeated field of type `gis.protobuf.Point2D`: `point`.
GeoJSON representation of this message is
~~~js
{
'type': 'LineString',
'coordinates': [[x1, y1], [x2, y2]]
}
~~~#### LineString3D
Structure with one repeated field of type `gis.protobuf.Point3D`: `point`.
GeoJSON representation of this message is
~~~js
{
'type': 'LineString',
'coordinates': [[x1, y1, z1], [x2, y2, z2]]
}
~~~#### MultiLineString2D
Structure with one repeated field of type `gis.protobuf.LineString2D`: `line_string`.
GeoJSON representation of this message is
~~~js
{
'type': 'MultiLineString',
'coordinates': [[[x1, y1], [x2, y2]], [[x3, y3], [x4, y4]]]
}
~~~#### MultiLineString3D
Structure with one repeated field of type `gis.protobuf.LineString3D`: `line_string`.
GeoJSON representation of this message is
~~~js
{
'type': 'MultiLineString',
'coordinates': [[[x1, y1, z1], [x2, y2, z2]], [[x3, y3, z3], [x4, y4, z4]]]
}
~~~### Polygon
~~~
syntax = "proto3";import "gis/protobuf/point.proto";
package test;
message Test {
gis.protobuf.Polygon2D polugon2d = 1;
gis.protobuf.Polygon3D polugon3d = 2;
gis.protobuf.MultiPolygon2D multi_polugon2d = 3;
gis.protobuf.MultiPolygon3D multi_polugon3d = 4;
}
~~~#### Polygon2D
Structure with one repeated field of type `gis.protobuf.Point2D`: `point`.
GeoJSON representation of this message is
~~~js
{
'type': 'Polygon',
'coordinates': [[[x1, y1], [x2, y2]]]
}
~~~#### Polygon3D
Structure with one repeated field of type `gis.protobuf.Point3D`: `point`.
GeoJSON representation of this message is
~~~js
{
'type': 'Polygon',
'coordinates': [[[x1, y1, z1], [x2, y2, z2]]]
}
~~~#### MultiPolygon2D
Structure with one repeated field of type `gis.protobuf.Polygon2D`: `polygon`.
GeoJSON representation of this message is
~~~js
{
'type': 'MultiPolygon',
'coordinates': [[[[x1, y1], [x2, y2]]], [[[x3, y3], [x4, y4]]]]
}
~~~#### MultiPolygon3D
Structure with one repeated field of type `gis.protobuf.Polygon3D`: `polygon`.
GeoJSON representation of this message is
~~~js
{
'type': 'MultiPolygon',
'coordinates': [[[[x1, y1, z1], [x2, y2, z2]]], [[[x3, y3, z3], [x4, y4, z4]]]]
}
~~~## Usage
In `proto/test.proto` file:
~~~
syntax = "proto3";import "gis/protobuf/point.proto";
package test;
message Test {
gis.protobuf.Point2D point = 1;
}
~~~