Skip to content

Commit 162a929

Browse files
committed
add API.md file
1 parent ff798fc commit 162a929

File tree

2 files changed

+44
-41
lines changed

2 files changed

+44
-41
lines changed

API.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# API
2+
3+
## Available spatial classes
4+
5+
* `Point(float $latitude, float $longitude)` - [MySQL Point](https://dev.mysql.com/doc/refman/8.0/en/gis-class-point.html)
6+
* `MultiPoint(Point[] | Collection<Point>)` - [MySQL MultiPoint](https://dev.mysql.com/doc/refman/8.0/en/gis-class-multipoint.html)
7+
* `LineString(Point[] | Collection<Point>)` - [MySQL LineString](https://dev.mysql.com/doc/refman/8.0/en/gis-class-linestring.html)
8+
* `MultiLineString(LineString[] | Collection<LineString>)` - [MySQL MultiLineString](https://dev.mysql.com/doc/refman/8.0/en/gis-class-multilinestring.html)
9+
* `Polygon(LineString[] | Collection<LineString>)` - [MySQL Polygon](https://dev.mysql.com/doc/refman/8.0/en/gis-class-polygon.html)
10+
* `MultiPolygon(Polygon[] | Collectiogit n<Polygon>)` - [MySQL MultiPolygon](https://dev.mysql.com/doc/refman/8.0/en/gis-class-multipolygon.html)
11+
* `GeometryCollection(Geometry[] | Collection<Geometry>)` - [MySQL GeometryCollection](https://dev.mysql.com/doc/refman/8.0/en/gis-class-geometrycollection.html)
12+
13+
## Available spatial functions
14+
15+
* `toWkt` - Mostly used internally
16+
* `toArray`
17+
* `toJson`
18+
* `fromWkb` - Mostly used internally
19+
* `fromJson`
20+
* `toFeatureCollectionJson`
21+
* `getCoordinates`
22+
23+
Geometry collection functions:
24+
25+
* `toCollectionWkt` - Mostly used internally
26+
* `getGeometries` - (explanation...) Can be used with `ArrayAccess` as well
27+
28+
## Available spatial scopes
29+
30+
* `withDistance(string $column, Geometry | string $geometryOrColumn, string $alias = 'distance')`
31+
* `whereDistance(string $column, Geometry | string $geometryOrColumn, string $operator, int | float $distance)`
32+
* `orderByDistance(string $column, Geometry | string $geometryOrColumn, string $direction = 'asc')`
33+
* `withDistanceSphere(string $column, Geometry | string $geometryOrColumn, string $alias = 'distance')`
34+
* `whereDistanceSphere(string $column, Geometry | string $geometryOrColumn, string $operator, int | float $distance)`
35+
* `orderByDistanceSphere(string $column, Geometry | string $geometryOrColumn, string $direction = 'asc')`
36+
* `whereWithin(string $column, Geometry | string $geometryOrColumn)`
37+
* `whereContains(string $column, Geometry | string $geometryOrColumn)`
38+
* `whereTouches(string $column, Geometry | string $geometryOrColumn)`
39+
* `whereIntersects(string $column, Geometry | string $geometryOrColumn)`
40+
* `whereCrosses(string $column, Geometry | string $geometryOrColumn)`
41+
* `whereDisjoint(string $column, Geometry | string $geometryOrColumn)`
42+
* `whereOverlaps(string $column, Geometry | string $geometryOrColumn)`
43+
* `whereEquals(string $column, Geometry | string $geometryOrColumn)`

readme.md renamed to README.md

Lines changed: 1 addition & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -133,47 +133,7 @@ echo $vacationCity->area->toJson(); // {"type":"Polygon","coordinates":[[[41.907
133133

134134
## API
135135

136-
### Available spatial classes
137-
138-
* `Point(float $latitude, float $longitude)` - [MySQL Point](https://dev.mysql.com/doc/refman/8.0/en/gis-class-point.html)
139-
* `MultiPoint(Point[] | Collection<Point>)` - [MySQL MultiPoint](https://dev.mysql.com/doc/refman/8.0/en/gis-class-multipoint.html)
140-
* `LineString(Point[] | Collection<Point>)` - [MySQL LineString](https://dev.mysql.com/doc/refman/8.0/en/gis-class-linestring.html)
141-
* `MultiLineString(LineString[] | Collection<LineString>)` - [MySQL MultiLineString](https://dev.mysql.com/doc/refman/8.0/en/gis-class-multilinestring.html)
142-
* `Polygon(LineString[] | Collection<LineString>)` - [MySQL Polygon](https://dev.mysql.com/doc/refman/8.0/en/gis-class-polygon.html)
143-
* `MultiPolygon(Polygon[] | Collection<Polygon>)` - [MySQL MultiPolygon](https://dev.mysql.com/doc/refman/8.0/en/gis-class-multipolygon.html)
144-
* `GeometryCollection(Geometry[] | Collection<Geometry>)` - [MySQL GeometryCollection](https://dev.mysql.com/doc/refman/8.0/en/gis-class-geometrycollection.html)
145-
146-
### Available spatial functions
147-
148-
* `toWkt` - Mostly used internally
149-
* `toArray`
150-
* `toJson`
151-
* `fromWkb` - Mostly used internally
152-
* `fromJson`
153-
* `toFeatureCollectionJson`
154-
* `getCoordinates`
155-
156-
Geometry collection functions:
157-
158-
* `toCollectionWkt` - Mostly used internally
159-
* `getGeometries` - (explanation...) Can be used with `ArrayAccess` as well
160-
161-
### Available spatial scopes
162-
163-
* `withDistance(string $column, Geometry | string $geometryOrColumn, string $alias = 'distance')`
164-
* `whereDistance(string $column, Geometry | string $geometryOrColumn, string $operator, int | float $distance)`
165-
* `orderByDistance(string $column, Geometry | string $geometryOrColumn, string $direction = 'asc')`
166-
* `withDistanceSphere(string $column, Geometry | string $geometryOrColumn, string $alias = 'distance')`
167-
* `whereDistanceSphere(string $column, Geometry | string $geometryOrColumn, string $operator, int | float $distance)`
168-
* `orderByDistanceSphere(string $column, Geometry | string $geometryOrColumn, string $direction = 'asc')`
169-
* `whereWithin(string $column, Geometry | string $geometryOrColumn)`
170-
* `whereContains(string $column, Geometry | string $geometryOrColumn)`
171-
* `whereTouches(string $column, Geometry | string $geometryOrColumn)`
172-
* `whereIntersects(string $column, Geometry | string $geometryOrColumn)`
173-
* `whereCrosses(string $column, Geometry | string $geometryOrColumn)`
174-
* `whereDisjoint(string $column, Geometry | string $geometryOrColumn)`
175-
* `whereOverlaps(string $column, Geometry | string $geometryOrColumn)`
176-
* `whereEquals(string $column, Geometry | string $geometryOrColumn)`
136+
Please see [API](API.md) for more informative API documentation.
177137

178138
## Tip for better IDE support
179139

0 commit comments

Comments
 (0)