位置情報の利用

KiiObject の JSON ドキュメントでは、緯度経度で表現された位置情報を扱うことができます。

位置情報は、以下のように、特定のキーに対する JSON オブジェクトとして格納できます。サービス仕様によっては、複数の位置情報を格納することもできます。

KiiObject の内部に位置情報を格納しておくと、2 点で囲まれた長方形の範囲の検索(GeoBox 検索)や、指定した位置を中心とした円形の範囲の検索(GeoDistance 検索)ができます。上の JSON ドキュメントの場合、location キーを検索の条件に指定して、範囲内の KiiObject の一覧を取得できます。

また、位置情報の検索条件はクエリーの一部として指定できるため、他の検索条件(例:「"score" が 70 より大きい KiiObject を検索」)を And や Or で組み合わせた検索も実現できます。

位置情報は KiiObject での特定の属性値として固定的に指定するわけではなく、JSON ドキュメントでのデータ型の 1 つとして、他のカスタムフィールドと同等に扱うことができます。サービス仕様に基づくデータ設計を行う際には、JSON による高い自由度はそのままに、位置情報を活用できます。


この機能の詳細は...

  • 位置情報の機能の詳細については、リファレンスガイドの「位置情報管理」(AndroidiOSJavaScriptREST)を参照してください。