1.2.1 - en to ja translation catalogue (59 entries)

en: Execution example::
ja: 実行例::

en: Summary
ja: 概要

en: ``geo_distance`` calculates the value of distance between specified two points.
ja: ``geo_distance`` は二点間の距離を計算します。

en: Syntax
ja: 構文

en: ``geo_distance`` requires two point. The parameter ``approximate_type`` is optional::
ja: ``geo_distance`` は二つの点を指定します。引数 ``approximate_type`` は省略可能です。

en: The default value of ``approximate_type`` is ``"rectangle"``. If you omit ``approximate_type``, ``geo_distance`` calculates the value of distance as if ``"rectangle"`` was specified.
ja: ``approximate_type`` のデフォルト値は ``"rectangle"`` です。 ``approximate_type`` を省略した場合、 ``geo_distance`` は二点間の距離を ``"rectangle"`` が指定されたものとして計算します。

en: Usage
ja: 使い方

en: ``geo_distance`` is one of the Groonga builtin functions.
ja: ``geo_distance`` はGroongaの組み込み関数の一つです。

en: You can call a builtin function in :doc:`/reference/grn_expr`
ja: 組み込み関数を :doc:`/reference/grn_expr` にて使うことができます。

en: ``geo_distance`` function calculates the value of distance (approximate value) between the coordinate of ``point1`` and the coordinate of ``point2``.
ja: ``geo_distance`` 関数は ``point1`` と ``point2`` の座標値から二点間の距離(近似値)を計算します。

en: Groonga provides three built in functions for calculating the value of distance. There are ``geo_distance()``, ``geo_distance2()`` and ``geo_distance3()``. The difference of them is the algorithm of calculating distance. ``geo_distance2()`` and ``geo_distance3()`` were deprecated since version 1.2.9. Use ``geo_distance(point1, point2, "sphere")`` instead of ``geo_distance2(point1, point2)``. Use ``geo_distance(point1, point2, "ellipsoid")`` instead of ``geo_distance3(point1, point2)``.
ja: Groongaは三つの組み込み関数を距離の計算のために提供しています。 ``geo_distance()`` 、 ``geo_distance2()`` 、 ``geo_distance3()`` です。これらの違いは距離の計算アルゴリズムにあります。 ``geo_distance2()`` と ``geo_distance3()`` はバージョン1.2.9より非推奨となりました。 ``geo_distance2(point1, point2)`` の代りに ``geo_distance(point1, point2, "sphere")`` を使用してください。 ``geo_distance3(point1, point2)`` の代りに ``geo_distance(point1, point2, "ellipsoid")`` を使用してください。

en: Lets's learn about ``geo_distance`` usage with examples. This section shows simple usages.
ja: 例とともに ``geo_distance`` について学びましょう。このセクションでは簡単な例を示します。

en: Here are two schema definition and sample data to show the difference according to the usage. Those samples show how to calculate the value of distance between New York City and London.
ja: 使い方による違いがわかるようにスキーマ定義とサンプルデータを用意しました。これらのサンプルはニューヨークとロンドンを例に距離の計算方法を示します。

en: Using the column value of location for calculating the distance (``Cities`` table)
ja: 距離の計算にlocationカラムの値を使う ( ``Cities`` テーブル)

en: Using the explicitly specified coordinates for calculating the distance (``Geo`` table)
ja: 距離の計算に明示的に指定した座標値を使う ( ``Geo`` テーブル)

en: Using the column value of location
ja: locationカラムの値を使う

en: Here are a schema definition of ``Cities`` table and sample data to show usage.
ja: 使用例を示すための ``Cities`` テーブルのスキーマ定義とサンプルデータは以下の通りです。

en: This execution example creates a table named ``Cities`` which has one column named ``location``. ``location`` column stores the value of coordinate. The coordinate of Tokyo is stored as sample data.
ja: この実行例では ``location`` というカラムを持つ ``Cities`` テーブルを作成します。 ``location`` カラムには座標値を保存します。東京の座標値がサンプルデータとして保存されています。

en: This sample shows that ``geo_distance`` use the value of ``location`` column and the value of coordinate to calculate distance.
ja: このサンプルは ``geo_distance`` が ``location`` カラムと座標値から距離を計算していることを示します。

en: The value ("185428000x-461000") passed to ``geo_distance`` as the second argument is the coordinate of London.
ja: ``geo_distance`` の第二引数として渡された値 ("185428000x-461000")はロンドンの座標値です。

en: Using the explicitly specified value of location
ja: 明示的に指定した位置を使う

en: Here are a schema definition of ``Geo`` table and sample data to show usage.
ja: 使用例を示すための ``Geo`` テーブルのスキーマ定義とサンプルデータは以下の通りです。

en: This execution example creates a table named ``Geo`` which has one column named ``distance``. ``distance`` column stores the value of distance.
ja: この実行例では ``distance`` カラムを持つ ``Geo`` テーブルを作成します。 ``distance`` カラムには距離を保存します。

en: This sample shows that ``geo_distance`` use the coordinate of London and the coordinate of New York to calculate distance.
ja: このサンプルは ``geo_distance`` がロンドンの座標とニューヨークの座標から距離を計算していることを示します。

en: Parameters
ja: 引数

en: Required parameters
ja: 必須引数

en: There are two required parameter, ``point1`` and ``point2``.
ja: 必須引数は二つあります。 ``point1`` と ``point2`` です。

en: Specifies the start point that you want to calculate the value of distance between two points.
ja: 計算しようとしている二点間の開始地点を指定します。

en: You can specify the value of GeoPoint type. [#]_
ja: GeoPoint型の値を指定することができます。 [#]_

en: See :doc:`/reference/types` about GeoPoint.
ja: GeoPointについては :doc:`/reference/types` を参照してください。

en: Specifies the end point that you want to calculate the value of distance between two points.
ja: 計算しようとしている二点間の終了地点を指定します。

en: You can specify the value of GeoPoint type or the string indicating the coordinate.
ja: GeoPoint型の値か座標を表す文字列を指定することができます。

en: See :doc:`/reference/types` about GeoPoint and the coordinate.
ja: GeoPointと座標については :doc:`/reference/types` を参照してください。

en: Optional parameter
ja: 省略可能引数

en: There is a optional parameter, ``approximate_type``.
ja: 省略可能な引数として ``approximate_type`` があります。

en: Specifies how to approximate the geographical features for calculating the value of distance.
ja: 距離を計算するときに地形をどのように近似するかを指定します。

en: You can specify the value of ``approximate_type`` by one of the followings.
ja: ``approximate_type`` の値は以下を指定することができます。

en: There is a limitation about ``geo_distance``. ``geo_distance`` can not calculate the value of distance between two points across meridian, equator or the date line if you use ``sphere`` or ``ellipsoid`` as approximate type. There is not such a limitation for ``rectangle``. This is temporary limitation according to the implementation of Groonga, but it will be fixed in the future release.
ja: ``geo_distance`` には制限があります。 ``sphere`` や ``ellipsoid`` を近似方法として選択した場合、子午線や日付変更線、赤道といった境界をまたぐ距離の計算を行うことができません。この制限は ``rectangle`` を近似方法として選択した場合にはありません。これはGroongaの実装上の一時的な制限ですが、将来的には修正される予定です。

en: This parameter require to approximate the geographical features by square approximation for calculating the distance.
ja: この引数を指定すると地形を方形近似して距離を計算します。

en: Since the value of distance is calculated by simple formula, you can calculate the value of distance fast. But, the error of distance increases as it approaches the pole.
ja: 簡易な式で距離の計算を行うので、高速に距離を求めることができますが、極付近では誤差が増大します。

en: You can also specify ``rect`` as abbrev expression.
ja: ``rect`` を省略表記として指定することができます。

en: Here is a sample about calculating the value of distance with column value.
ja: カラムの値で距離を計算するサンプルは以下の通りです。

en: Here is a sample about calculating the value of distance with explicitly specified point.
ja: 明示的に位置を指定して距離を計算するサンプルは以下の通りです。

en: Here are samples about calculating the value of distance with explicitly specified point across meridian, equator, the date line.
ja: 明示的に子午線や赤道、日付変更線をまたぐような位置を指定して距離を計算するサンプルは以下の通りです。

en: This sample shows the value of distance across meridian. The return value of ``geo_distance("175904000x8464000", "145508000x-13291000", "rectangle")`` is the value of distance from Paris, Flance to Madrid, Spain.
ja: このサンプルは子午線をまたいだ場合の距離を示します。 ``geo_distance("175904000x8464000", "145508000x-13291000", "rectangle")`` はパリ(フランス)からマドリード(スペイン)間の距離を返します。

en: This sample shows the value of distance across equator. The return value of ``geo_distance("146566000x-266422000", "-56880000x-172310000", "rectangle")`` is the value of distance from New York, The United Status to Brasillia, Brasil.
ja: このサンプルは赤道をまたいだ場合の距離を示します。 ``geo_distance("146566000x-266422000", "-56880000x-172310000", "rectangle")`` はニューヨーク(アメリカ)からブラジリア(ブラジル)間の距離を返します。

en: This sample shows the value of distance across the date line. The return value of ``geo_distance("143660000x419009000", "135960000x-440760000", "rectangle")`` is the value of distance from Beijin, China to San Francisco, The United States.
ja: このサンプルは日付変更線をまたいだ場合の距離を示します。 ``geo_distance("143660000x419009000", "135960000x-440760000", "rectangle")`` は北京(中国)からサンフランシスコ(アメリカ)間の距離を返します。

en: ``geo_distance`` uses square approximation as default. If you omit ``approximate_type``, ``geo_distance`` behaves like ``rectangle`` was specified.
ja: ``geo_distance`` は方形近似をデフォルトとして使用します。 ``approximate_type`` を省略すると ``geo_distance`` は ``rectangle`` が指定されたものとして振舞います。

en: ``geo_distance`` accepts the string indicating the coordinate as the value of ``point1`` when the value of ``approximate_type`` is ``"rectangle"``. If you specified the string indicating the coordinate as the value of ``point1`` with ``sphere`` or ``ellipsoid``, ``geo_distance`` returns 0 as the value of distance.
ja: ``geo_distance`` は ``approximate_type`` の値が ``"rectangle"`` であるときに ``point1`` の値として座標を表す文字列を受けつけます。もし ``sphere`` や ``ellipsoid`` と一緒に座標を表す文字列を ``point1`` へ指定した場合、 ``geo_distance`` は距離の値として0を返します。

en: This parameter require to approximate the geographical features by spherical approximation for calculating the distance.
ja: この引数を指定すると球面近似で地形を近似して距離を計算します。

en: It is slower than ``rectangle``, but the error of distance becomes smaller than ``rectangle``.
ja: 球面近似は ``rectangle`` よりも遅いです。しかし ``rectangle`` よりも誤差は小さくなります。

en: You can also specify ``sphr`` as abbrev expression.
ja: ``sphr`` を省略表記として指定することができます。

en: This parameter require to approximate the geographical features by ellipsoid approximation for calculating the distance.
ja: この引数を指定すると楕円近似で地形を近似して距離を計算します。

en: It uses the calculation of distance by the formula of Hubeny. It is slower than ``sphere``, but the error of distance becomes smaller than ``sphere``.
ja: ヒュベニの距離計算式により距離を計算します。 ``sphere`` よりも遅いですが、 ``sphere`` より誤差は小さくなります。

en: You can also specify ``ellip`` as abbrev expression.
ja: ``ellip`` を省略表記として指定することができます。

en: Return value
ja: 戻り値

en: ``geo_distance`` returns the value of distance in float type. The unit of return value is meter.
ja: ``geo_distance`` はFloat型の値を距離として返します。単位はメートルです。

en: Footnote
ja: 脚注

en: You can specify whether TokyoGeoPoint or WGS84GeoPoint.
ja: 日本測地系座標か世界測地系座標のいずれかを指定することができます。
