# groonga - オープンソースのカラムストア機能付き全文検索エンジン

- English

# 7.25.12. `grn_geo`

## 7.25.12.1. 概要

TODO...

## 7.25.12.2. 例

TODO...

## 7.25.12.3. リファレンス

type `grn_geo_point`

grn_rc `grn_geo_select_in_rectangle`(grn_ctx *ctx, grn_obj *index, grn_obj *top_left_point, grn_obj *bottom_right_point, grn_obj *res, grn_operator op)

  It selects records that are in the rectangle specified by top_left_point parameter and bottom_right_point parameter. Records are searched by index parameter. Found records are added to res parameter table with op parameter operation.

  パラメータ

    - index -- the index column for TokyoGeoPoint or WGS84GeoPpoint type.

    - top_left_point -- the top left point of the target rectangle. (ShortText, Text, LongText, TokyoGeoPoint or WGS84GeoPoint)

    - bottom_right_point -- the bottom right point of the target rectangle. (ShortText, Text, LongText, TokyoGeoPoint or WGS84GeoPoint)

    - res -- the table to store found record IDs. It must be `GRN_TABLE_HASH_KEY` type table.

    - op -- the operator for matched records.

int `grn_geo_estimate_in_rectangle`(grn_ctx *ctx, grn_obj *index, grn_obj *top_left_point, grn_obj *bottom_right_point)

  It estimates number of records in the rectangle specified by top_left_point parameter and bottom_right_point parameter. Number of records is estimated by index parameter. If an error is occurred, -1 is returned.

  パラメータ

    - index -- the index column for TokyoGeoPoint or WGS84GeoPpoint type.

    - top_left_point -- the top left point of the target rectangle. (ShortText, Text, LongText, TokyoGeoPoint or WGS84GeoPoint)

    - bottom_right_point -- the bottom right point of the target rectangle. (ShortText, Text, LongText, TokyoGeoPoint or WGS84GeoPoint)

grn_obj *`grn_geo_cursor_open_in_rectangle`(grn_ctx *ctx, grn_obj *index, grn_obj *top_left_point, grn_obj *bottom_right_point, int offset, int limit)

  It opens a cursor to get records in the rectangle specified by top_left_point parameter and bottom_right_point parameter.

  パラメータ

    - index -- the index column for TokyoGeoPoint or WGS84GeoPpoint type.

    - top_left_point -- the top left point of the target rectangle. (ShortText, Text, LongText, TokyoGeoPoint or WGS84GeoPoint)

    - bottom_right_point -- the bottom right point of the target rectangle. (ShortText, Text, LongText, TokyoGeoPoint or WGS84GeoPoint)

    - offset -- the cursor returns records from offset parameter position. offset parameter is based on 0.

    - limit -- the cursor returns at most limit parameter records. -1 means no limit.

grn_posting *`grn_geo_cursor_next`(grn_ctx *ctx, grn_obj *cursor)

  It returns the next posting that has record ID. It returns NULL after all records are returned.

  パラメータ

    - cursor -- the geo cursor.