Bug #102513 Proposal for the Japanese 8.0 document correction(Spatial functions).

Submitted: 7 Feb 2021 3:06 Modified: 24 Apr 2021 14:22
Reporter: Kei SAKAI (OCA) Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Japanese Documentation Severity:S3 (Non-critical)
Version:8.0 OS:Any
Assigned to: Ryusuke Kajiyama CPU Architecture:Any

[7 Feb 2021 3:06] Kei SAKAI 
Description:
Proposal for the Japanese 8.0 document correction(Spatial functions).

===
< 12.17.7.2 点プロパティー関数
---
> 12.17.7.2 Pointプロパティー関数

===

< 12.17.7.4 ♪多角形および MultiPolygon プロパティ関数
---
> 12.17.7.4 ♪Polygonおよび MultiPolygon プロパティ関数

===

< 幾何値 g の固有の次元を返します。 ♪dimension には− 1、0、1、2 を指定できます。 これらの値の意味は、セクション11.4.2.2「Geometry クラス」で指定されています。
---
> 幾何値 g の固有の次元を返します。 ♪dimension は− 1、0、1、2 の値を取ります。 これらの値の意味は、セクション11.4.2.2「Geometry クラス」で指定されています。

===

< 幾何値 g の最小外接矩形 (MBR) を返します。 結果は、その外接矩形の角の点によって定義された Polygon 値として返されます。
---
> 幾何値 g の最小外接矩形 (MBR) を返します。 結果は、その外接矩形の角の点によって定義される Polygon 値として返されます。

===

< ♪引数が点、垂直線セグメントまたは水平線セグメントの場合、ST_Envelope() は無効なポリゴンを戻すのではなく、点または線セグメントを MBR として戻します:
---
> ♪引数が点、垂直または水平の線セグメントの場合、ST_Envelope() は無効なポリゴンを戻すのではなく、点または線セグメントを MBR として戻します:

===

< ♪ST_SRID() は、有効なジオメトリオブジェクト g を表す単一の引数を使用して、g に関連付けられた空間参照システム (SRS) の ID を示す整数を戻します。
< ♪オプションの秒引数が有効な SRID 値を表す場合、ST_SRID() は、SRID 値が 2 番目の引数と等しい最初の引数と同じ型のオブジェクトを戻します。 ♪これにより、オブジェクトの SRID 値のみが設定され、座標値の変換は実行されません。
---
> ♪引数として有効なジオメトリオブジェクト g をひとつだけ与えた場合、ST_SRID() は、g に関連付けられた空間参照システム (SRS) の ID を示す整数を戻します。
> ♪オプションである2番目の引数として有効な SRID 値を与えた場合、ST_SRID() は、SRID 値が 2 番目の引数と等しい最初の引数 と同じ型のオブジェクトを戻します。 ♪これにより、オブジェクトの SRID 値のみが設定され、座標値の変換は実行されません。

===

(... will be continue to comment section.)

How to repeat:
see above and comments.
[7 Feb 2021 3:07] Kei SAKAI 
(continued.)

===

< ♪ただし、このメソッドは SRID 0 にジオメトリを作成し、SRID 4326 (WGS 84) にキャストします。 ♪最初に正しい空間参照システムを使用してジオメトリを作成することをお薦めします。 例:
---
> ♪ただし、このメソッドは SRID 0 にジオメトリを作成してから、SRID 4326 (WGS 84) にキャストします。 ♪初めから正しい空間参照システムを使用してジオメトリを作成することをお薦めします。 例:

===

< 12.17.7.2 点プロパティー関数
< ♪Point は X 座標と Y 座標で構成され、それぞれ ST_X() 関数と ST_Y() 関数を使用して取得できます。 ♪これらの関数では、X または Y 座標値を指定するオプションの秒引数も許可されます。この場合、関数の結果は最初の引数の Point オブジェクトになり 、適切な座標は 2 番目の引数と等しくなるように変更されます。
< ♪地理空間参照システム (SRS) を持つ Point オブジェクトの場合、経度および緯度は、それぞれ ST_Longitude() 関数および ST_Latitude() 関数を使用して取得できます。 ♪これらの関数では、経度または緯度の値を指定するオプションの秒引数も許可されます。この場合、関数の結果は、経度または緯度が変更された最初の引数の Point オブジェクトとなり、2 番目の引数と等しくなります 。
---
> 12.17.7.2 Pointプロパティー関数
> ♪Point は X 座標と Y 座標で構成され、それぞれ ST_X() 関数と ST_Y() 関数を使用して取得できます。 ♪これらの関数では、X または Y 座標値を指定するオプションの2番目の引数も許可されます。この場合、関数の結果は最初の引数の Point オブジェクトから、適切な座標が 2 番目の引数の値に変更されたものとなります。
> ♪地理空間参照システム (SRS) を持つ Point オブジェクトの場合、経度および緯度は、それぞれ ST_Longitude() 関数および ST_Latitude() 関数を使用して取得できます。 ♪これらの関数ではオプションとして、経度または緯度の値を指定する2番目の引数も許 可されます。この場合、関数の結果は、最初の引数の Point オブジェクトから経度または緯度が2 番目の引数の値に変更されたもの となります。

===

< ♪ポイントプロパティを取得するには、次の関数を使用できます:
---
> ♪Pointプロパティを取得するには、次の関数を使用できます:

===

< ♪地理空間参照システム (SRS) を持つ有効な Point オブジェクト p を表す単一の引数を使用すると、ST_Latitude() は p の緯度値を倍精度数値として返します。
< ♪有効な緯度値を表すオプションの秒引数を使用すると、ST_Latitude() は、最初の引数のように、緯度が 2 番目の引数と等しい Point オブジェクトを返します。
---
> ♪引数として、地理空間参照システム (SRS) を持つ有効な Point オブジェクト p をひとつだけ与えると、ST_Latitude() は p の緯度値を倍精度数値として返します。
> ♪オプションである2番目の引数として、有効な緯度値を与えると、ST_Latitude() は、1番目の引数の値から、緯度を 2 番目の引 数に変更した Point オブジェクトを返します。

===

< ♪地理空間参照システム (SRS) を持つ有効な Point オブジェクト p を表す単一の引数を使用すると、ST_Longitude() は p の経 度値を倍精度数値として返します。
< ♪オプションの秒引数が有効な経度値を表す場合、ST_Longitude() は、経度が 2 番目の引数と等しい最初の引数のような Point  オブジェクトを返します。
---
> ♪引数として、地理空間参照システム (SRS) を持つ有効な Point オブジェクト p をひとつだけ与えると、ST_Longitude() は p  の経度値を倍精度数値として返します。
> ♪オプションである2番目の引数として有効な経度値を与えた場合、ST_Longitude() は、1番目の引数の値から、経度を 2 番目の引数の値に変更した Point オブジェクトを返します。

===

< ♪有効な Point オブジェクト p を表す単一の引数を使用すると、ST_X() は p の X 座標値を倍精度数値として返します。 ♪MySQL 8.0.12 では、X 座標は Point 空間参照システム (SRS) 定義で最初に表示される軸を参照しているとみなされます。
< ♪オプションの second 引数を指定すると、ST_X() は、X 座標が 2 番目の引数と等しい最初の引数のような Point オブジェクト を返します。 ♪MySQL 8.0.12 では、Point オブジェクトに地理 SRS がある場合、2 番目の引数は経度または緯度の値の適切な範囲 内にある必要があります。
---
> ♪引数として、有効な Point オブジェクト p をひとつだけ与えると、ST_X() は p の X 座標値を倍精度数値として返します。 ♪MySQL 8.0.12 では、X 座標は Point 空間参照システム (SRS) 定義で最初に表示される軸を参照しているとみなされます。
> ♪オプションである2番目の引数を指定すると、ST_X() は、1番目の引数であるPoint オブジェクトのX 座標が 2 番目の引数となったものを返します。 ♪MySQL 8.0.12 では、Point オブジェクトに地理 SRS がある場合、2 番目の引数は経度または緯度の値の適切 な範囲内にある必要があります。

===

< ♪オプションの second 引数を指定すると、ST_Y() は、Y 座標が 2 番目の引数と等しい最初の引数のような Point オブジェクト を返します。 ♪MySQL 8.0.12 では、Point オブジェクトに地理 SRS がある場合、2 番目の引数は経度または緯度の値の適切な範囲 内にある必要があります。
---
> ♪オプションである2番目の引数を指定すると、ST_Y() は、1番目の引数であるPoint オブジェクトのY 座標が 2 番目の引数となったものを返します。 ♪MySQL 8.0.12 では、Point オブジェクトに地理 SRS がある場合、2 番目の引数は経度または緯度の値の適切 な範囲内にある必要があります。
[7 Feb 2021 3:09] Kei SAKAI 
(continued.)

===

< LineString は、Point 値で構成されます。 LineString の特定の点を抽出したり、そこに含まれている点の数をカウントしたり、 その長さを取得したりできます。
---
> LineString は、Point 値で構成されます。 LineString の特定の点を抽出したり、そこに含まれているPointの数をカウントしたり、その長さを取得したりできます。

===

< ♪LineString 値が ls の場合、ls がクローズされると、ST_IsClosed() は 1 を返します (つまり、ST_StartPoint() と ST_EndPoint() の値が同じです)。
< ♪MultiLineString 値が ls の場合、ls がクローズされると、ST_IsClosed() は 1 を返します (つまり、ST_StartPoint() と ST_EndPoint() の値は ls の LineString ごとに同じです)。
< ♪ST_IsClosed() は、ls がクローズされていない場合は 0 を返し、ls が NULL の場合は NULL を返します。
---
> ♪LineString 値ls について、ls が閉じている場合(すなわち、ST_StartPoint() と ST_EndPoint() が同じ値の場合)、ST_IsClosed() は 1 を返します。
> ♪MultiLineString ls について、ls が閉じている場合(すなわち、ls内のそれぞれのLineStringについて、ST_StartPoint() と ST_EndPoint() が同じ値の場合)、ST_IsClosed() は 1 を返します。
> ♪ST_IsClosed() は、ls が閉じていない場合は 0 を返し、ls が NULL の場合は NULL を返します。

===

< o     ♪ユニットが指定されているが、MySQL でサポートされていない場合は、ER_UNIT_NOT_FOUND エラーが発生します。
---
> o     ♪単位が指定されているが、MySQL でサポートされていない場合は、ER_UNIT_NOT_FOUND エラーが発生します。

===

< o     ♪単位が指定されていない場合、結果はデカルトか地理的かにかかわらず、ジオメトリの SRS の単位になります。 ♪現在、すべての MySQL SRS はメーターで表されます。
---
> o     ♪単位が指定されていない場合、結果はデカルトか地理的かにかかわらず、ジオメトリの SRS の単位になります。 ♪現在、すべての MySQL SRS はメートルで表されます。

===

< 12.17.7.4 ♪多角形および MultiPolygon プロパティ関数
---
> 12.17.7.4 ♪Polygonおよび MultiPolygon プロパティ関数

===

< ♪ST_Buffer() では、distance 引数の後に最大 3 つのオプションの戦略引数を指定できます。 ♪戦略はバッファ計算に影響しま す。 ♪これらの引数は、ST_Buffer_Strategy() ファンクションによって生成されるバイト文字列値で、点、結合および終了方針に使用されます:
< o     ♪点方針は、Point および MultiPoint ジオメトリに適用されます。 ♪点ストラテジが指定されていない場合、デフォルト は ST_Buffer_Strategy('point_circle', 32) です。
< o     ♪結合方法は、LineString, MultiLineString, Polygon および MultiPolygon ジオメトリに適用されます。 ♪結合方針が指定されていない場合、デフォルトは ST_Buffer_Strategy('join_round', 32) です。
< o     ♪終了方針は、LineString および MultiLineString ジオメトリに適用されます。 ♪終了方針が指定されていない場合、デ フォルトは ST_Buffer_Strategy('end_round', 32) です。
< ♪各タイプの最大 1 つの戦略を指定でき、任意の順序で指定できます。
---
> ♪ST_Buffer() では、distance 引数の後に最大 3 つのオプションのストラテジ引数を指定できます。 ♪ストラテジはバッファ計 算に影響します。 ♪これらの引数は、ST_Buffer_Strategy() ファンクションによって生成されるバイト文字列値で、点、結合および終了のストラテジに使用されます:
> o     ♪点ストラテジは、Point および MultiPoint ジオメトリに適用されます。 ♪点ストラテジが指定されていない場合、デフ ォルトは ST_Buffer_Strategy('point_circle', 32) です。
> o     ♪結合ストラテジは、LineString, MultiLineString, Polygon および MultiPolygon ジオメトリに適用されます。 ♪結合ストラテジが指定されていない場合、デフォルトは ST_Buffer_Strategy('join_round', 32) です。
> o     ♪終了ストラテジは、LineString および MultiLineString ジオメトリに適用されます。 ♪終了ストラテジが指定されてい ない場合、デフォルトは ST_Buffer_Strategy('end_round', 32) です。
> ♪各タイプの最大 1 つのストラテジを指定でき、任意の順序で指定できます。

===

< o     ♪特定のタイプの戦略が複数指定されている場合は、ER_WRONG_ARGUMENTS エラーが発生します。
---
> o     ♪特定のタイプのストラテジが複数指定されている場合は、ER_WRONG_ARGUMENTS エラーが発生します。

===

< ♪このファンクションは、バッファの計算に影響を与えるために ST_Buffer() で使用する戦略バイト文字列を戻します。
< ♪戦略に関する情報は、Boost.org で入手できます。
< ♪最初の引数は、戦略オプションを示す文字列である必要があります:
< o     ♪ポイント戦略の場合、許可される値は'point_circle'および'point_square'です。
< o     ♪結合方針の場合、許可される値は'join_round'および'join_miter'です。
< o     ♪終了戦略の場合、許可される値は'end_round'および'end_flat'です。
---
> ♪このファンクションは、バッファの計算に影響を与えるために ST_Buffer() で使用するストラテジの、バイト文字列を戻します 。
> ♪ストラテジに関する情報は、Boost.org で入手できます。
> ♪最初の引数は、ストラテジのオプションを示す文字列である必要があります:
> o     ♪点ストラテジの場合、許可される値は'point_circle'および'point_square'です。
> o     ♪結合ストラテジの場合、許可される値は'join_round'および'join_miter'です。
> o     ♪終了ストラテジの場合、許可される値は'end_round'および'end_flat'です。

===

< ♪ジオメトリ値 g の凸型ハルを表すジオメトリを戻します。
< ♪このファンクションは、まず頂点ポイントが同一直線かどうかをチェックして、ジオメトリ凸型を計算します。 ♪その場合は線 形ハルを返し、それ以外の場合はポリゴンハルを返します。 ♪このファンクションは、コレクションのすべてのコンポーネントのす べての頂点ポイントを抽出し、そこから MultiPoint 値を作成して凸型を計算することで、ジオメトリコレクションを処理します。
---
> ♪ジオメトリ値 g の凸包を表すジオメトリを戻します。
> ♪このファンクションは、まず頂点ポイントが同一直線かどうかをチェックして、ジオメトリ凸包を計算します。 ♪その場合は線 形の外皮を返し、それ以外の場合はポリゴンの外皮を返します。 ♪このファンクションは、コレクションのすべてのコンポーネント のすべての頂点ポイントを抽出し、そこから MultiPoint 値を作成して凸包を計算することで、ジオメトリコレクションを処理します。
[7 Feb 2021 3:10] Kei SAKAI 
(continued.)

===

< ♪関連する関数 ST_LineInterpolatePoints() は同様の引数を取りますが、開始点からそのエンドポイントまでの距離の各部分の LineString に沿った Point 値で構成される MultiPoint を返します。 ♪両方の関数の例については、ST_LineInterpolatePoints()  の説明を参照してください。
---
> ♪関連する関数 ST_LineInterpolatePoints() も同様の引数を取りますが、その開始点から終了点までの距離の各部分の LineString に沿った Point 値で構成される MultiPoint を返します。 ♪両方の関数の例については、ST_LineInterpolatePoints() の説明を 参照してください。

===

< ♪このファンクションは、範囲 (0.0、1.0) 内の LineString ジオメトリおよび小数距離を取得し、LineString の開始点と、その 開始点からエンドポイントまでの距離の各部分の LineString に沿った Point 値で構成される MultiPoint を戻します。 ♪これを使用すると、ジオメトリ引数で記述された道路に沿って 10% ずつどの Point 値があるかなどの質問に答えることができます。
---
> ♪このファンクションは、範囲 (0.0、1.0) 内の LineString ジオメトリおよび小数距離を取得し、LineString の開始点と、その 開始点から終了点までの距離の各部分の LineString に沿った Point 値で構成される MultiPoint を戻します。 ♪これを使用すると、ジオメトリ引数で記述された道路に沿って 10% ずつどの Point 値があるかなどの質問に答えることができます。

===

< ♪関連する関数である ST_LineInterpolatePoint() は、同様の引数を取りますが、開始点からエンドポイントまでの指定された距 離で、LineString に沿って Point を返します。
---
> ♪関連する関数である ST_LineInterpolatePoint() も、同様の引数を取りますが、開始点から終了点までの指定された距離で、LineString に沿って Point を返します。

===

< •     ♪ユニットは、INFORMATION_SCHEMA ST_UNITS_OF_MEASURE テーブルで見つかった場合にサポートされます。 セクション26.37「♪INFORMATION_SCHEMA ST_UNITS_OF_MEASURE テーブル」を参照してください。
< •     ♪ユニットが指定されているが、MySQL でサポートされていない場合は、ER_UNIT_NOT_FOUND エラーが発生します。
---
> •     ♪単位は、INFORMATION_SCHEMA ST_UNITS_OF_MEASURE テーブルに存在しているものがサポートされます。 セクション26.37 「♪INFORMATION_SCHEMA ST_UNITS_OF_MEASURE テーブル」を参照してください。
> •     ♪単位が指定されているが、MySQL でサポートされていない場合は、ER_UNIT_NOT_FOUND エラーが発生します。

===

< •     ♪単位が指定されていない場合、結果はデカルトか地理的かにかかわらず、ジオメトリの SRS の単位になります。 ♪現在、すべての MySQL SRS はメーターで表されます。
---
> •     ♪単位が指定されていない場合、結果はデカルトか地理的かにかかわらず、ジオメトリの SRS の単位になります。 ♪現在、すべての MySQL SRS はメートルで表されます。

===

< ♪ジオメトリがどの程度類似しているかを反映して、2 つのジオメトリ間の離散フレシェ距離を返します。 ♪結果は、ジオメトリ 引数の空間参照システム (SRS) の長さ単位、または引数が指定されている場合は unit 引数の長さ単位で測定された倍精度の数値で す。
---
> ♪ジオメトリがどの程度類似しているかをあらわす、2 つのジオメトリ間の離散フレシェ距離を返します。 ♪結果は、ジオメトリ 引数の空間参照システム (SRS) の長さ単位、または引数が指定されている場合は unit 引数の長さ単位で測定された倍精度の数値で す。

===

< ♪ジオメトリがどの程度類似しているかを反映して、2 つのジオメトリ間の離散ハスドルフ距離を返します。 ♪結果は、ジオメト リ引数の空間参照システム (SRS) の長さ単位、または引数が指定されている場合は unit 引数の長さ単位で測定された倍精度の数値 です。
< ♪このファンクションは、離散ハスドルフ距離を実装します。つまり、ジオメトリの点間の距離に制限されます。 ♪たとえば、2  つの LineString 引数がある場合、ジオメトリに明示的に記述された点のみが考慮されます。 ♪これらの点の間の線分セグメント上 の点は考慮されません。
---
> ♪ジオメトリがどの程度類似しているかをあらわす、2 つのジオメトリ間の離散ハウスドルフ距離を返します。 ♪結果は、ジオメ トリ引数の空間参照システム (SRS) の長さ単位、または引数が指定されている場合は unit 引数の長さ単位で測定された倍精度の数 値です。
> ♪このファンクションは、離散ハウスドルフ距離を実装します。つまり、ジオメトリの点間の距離に制限されます。 ♪たとえば、2 つの LineString 引数がある場合、ジオメトリに明示的に記述された点のみが考慮されます。 ♪これらの点の間の線分セグメント上の点は考慮されません。

===

< 12.17.10 ♪空間ジオハッシュ関数
< ♪ジオハッシュは、任意の精度の緯度と経度の座標をテキスト文字列にエンコードするためのシステムです。 ♪ジオハッシュ値は 、"0123456789bcdefghjkmnpqrstuvwxyz"から選択された文字のみを含む文字列です。
< ♪このセクションのファンクションを使用すると、ジオハッシュデータのインポートとエクスポート、およびジオハッシュ値のインデックス付けと検索の機能をアプリケーションに提供するジオハッシュ値を操作できます。
---
> 12.17.10 ♪空間GeoHash関数
> ♪GeoHashは、任意の精度の緯度と経度の座標をテキスト文字列にエンコードするためのシステムです。 ♪GeoHash値は、"0123456789bcdefghjkmnpqrstuvwxyz"から選択された文字のみを含む文字列です。
> ♪このセクションのファンクションを使用すると、GeoHashデータのインポートとエクスポート、およびGeoHash値のインデックス付けと検索の機能をアプリケーションに提供するGeoHash値を操作できます。

===

< •     ♪いずれかの点引数に SRID 0 または 4326 がない場合は、ER_SRS_NOT_FOUND エラーが発生します。point 引数 SRID の有 効性はチェックされません。
---
> •     ♪いずれかのpoint引数に SRID 0 または 4326 がない場合は、ER_SRS_NOT_FOUND エラーが発生します。point 引数 SRID の有効性はチェックされません。
[7 Feb 2021 3:10] Kei SAKAI 
(continued.)

===

< ♪次のジオハッシュ関数を使用できます:
---
> ♪次のGeoHash関数を使用できます:

===

< ♪接続文字セットおよび照合順序でジオハッシュ文字列を戻します。
---
> ♪接続文字セットおよび照合順序でGeoHash文字列を戻します。

===

< ♪結果の文字列は max_length 文字以下で、上限は 100 です。 ♪ジオハッシュ値を作成するアルゴリズムでは、場所または max_length 文字の正確な表現のいずれか (いずれか早い方) の文字列が作成されるまで続行されるため、文字列が max_length 文字より短い場合があります。
---
> ♪結果の文字列は max_length 文字以下で、上限は 100 です。 ♪GeoHash値を作成するアルゴリズムでは、場所または max_length 文字の正確な表現のいずれか (いずれか早い方) の文字列が作成されるまで続行されるため、文字列が max_length 文字より短い場 合があります。

===

< ♪ジオハッシュ文字列値から緯度を[− 90, 90]の範囲の倍精度数値として返します。
---
> ♪GeoHash文字列値から緯度を[− 90, 90]の範囲の倍精度数値として返します。

===

< ♪ジオハッシュ文字列値から経度を[− 180, 180]の範囲の倍精度数値として返します。
---
> ♪GeoHash文字列値から経度を[− 180, 180]の範囲の倍精度数値として返します。

===

< ♪ジオハッシュ文字列値を指定して、デコードされたジオハッシュ値を含む POINT 値を戻します。
---
> ♪GeoHash文字列値を指定して、デコードされたGeoHash値を含む POINT 値を戻します。

===

< ♪スフィア上の Point または MultiPoint 引数間の最小球面距離をメートル単位で返します。 ♪(汎用の距離計算については、ST_Distance() 関数を参照してください。) ♪オプションの radius 引数はメートル単位で指定する必要があります。
---
> ♪球面上の Point または MultiPoint 引数間の最小球面距離をメートル単位で返します。 ♪(汎用の距離計算については、ST_Distance() 関数を参照してください。) ♪オプションの radius 引数はメートル単位で指定する必要があります。
[7 Feb 2021 4:40] MySQL Verification Team 
Hello Sakai-san,

Thank you for the report and feedback.

regards,
Umesh
[24 Apr 2021 14:22] Ryusuke Kajiyama 
Posted by developer:
 
Fixed in MySQL 8.0 Reference Manual (Japanese) 
https://dev.mysql.com/doc/refman/8.0/ja/gis-property-functions.html

Portions of this website are copyright © 2001, 2002 The PHP Group

Page generated in 0.059 sec. using MySQL 8.4.7-u6-cloud

Timestamp references displayed by the system are UTC.
Content reproduced on this site is the property of the respective copyright holders.
It is not reviewed in advance by Oracle and does not necessarily represent the opinion of Oracle or any other party.