null+****@clear*****
null+****@clear*****
2011年 9月 26日 (月) 23:37:52 JST
Kouhei Sutou 2011-09-26 14:37:52 +0000 (Mon, 26 Sep 2011)
New Revision: 392784fbea3a3f6eac333ef7dd45a51bb5411f6b
Log:
[doc][geo] add.
Added files:
doc/source/geolocation_search.txt
Modified files:
doc/source/index.txt
Added: doc/source/geolocation_search.txt (+49 -0) 100644
===================================================================
--- /dev/null
+++ doc/source/geolocation_search.txt 2011-09-26 14:37:52 +0000 (bff3637)
@@ -0,0 +1,49 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+Geolocation Search
+==================
+
+Groonga supports geolocation search. It uses index for
+search. It means that you can search by geolocation fast
+like fulltext search.
+
+Supported features
+------------------
+
+Groonga supports only point as data type. Line, surface and
+so on aren't supported yet. Here is a feature list:
+
+#. Groonga can store a point to a column.
+#. Groonga can search records that have a point in the specified rectangle.
+#. Groonga can calculate distance between two points.
+#. Groonga can sort records by distance from the specified
+ point in ascending order.
+
+Here are use cases for groonga's geolocation search:
+
+* You list McDonald's around a station.
+* You list KFS around the current location sort by distance
+ from the current location in ascending order with distance.
+
+Here are not use cases:
+
+* You search McDonald's in a city. (Groonga doesn't support
+ geolocation search by a shape except a rectangle and a
+ circle.)
+* You store a region instead of a point as a lake
+ record. (A column can't has geolocation data except a
+ point.)
+
+The following figures show about groonga's geolocation
+search features.
+
+Here is a figure that only has records. A black point
+describes a record. The following figures shows how records
+are treated.
+
+.. image:: /images/geo-points.png
+ :alt: only records
+ :align: center
+
Modified: doc/source/index.txt (+1 -0)
===================================================================
--- doc/source/index.txt 2011-09-26 14:37:22 +0000 (7940ff1)
+++ doc/source/index.txt 2011-09-26 14:37:52 +0000 (8946f2a)
@@ -19,6 +19,7 @@ groonga ドキュメント
community
tutorial
suggest
+ geolocation_search
reference
spec
limitations