Merge pull request #4128 from fisuda/patch

(JP) Add doc about Feature and FeatureCollection support (#4126)

doc/manuals.jp/user/ngsiv2_implementation_notes.md

@@ -222,14 +222,23 @@ NGSIv2 仕様では、`geo:json` 属性に使用される可能性のある GeoJ
 * Polygon
 * MultiPolygon
 
-その一方で、次のタイプは機能しません (使用しようとすると "Database Error" が発生します) :
+実施されたテストの詳細については、[こちら](https://github.com/telefonicaid/fiware-orion/issues/3586)をご覧ください。
 
-* Feature
-* GeometryCollection
-* FeatureCollection
+`Feature` タイプと `FeatureCollection` タイプもサポートされていますが、特別な方法です。`Feature` または `FeatureCollection`
+を使用して、`geo:json` 属性を作成/更新できます。ただし、属性値が取得されると (GET レスポンスまたは通知)、次のコンテンツのみが
+取得されます:
 
-実施されたテストの詳細については、
-[こちら](https://github.com/telefonicaid/fiware-orion/issues/3586)をご覧ください。
+* `Feature` の場合、`geometry` フィールド
+* `FeatureCollection` の場合、`features` 配列の最初のアイテムの `geometry` フィールド
+
+実際には、Orion は `Feature` または `FeatureCollection` の作成/更新時に使用される完全な値を保存することに注意してください。
+ただし、他の `geo:json` タイプでの正規化の観点から、`geometry` 部分のみを返すことが決定されました。将来的には、コンテンツ全体を
+返すフラグが実装される可能性があります (詳細は、[この Issue](https://github.com/telefonicaid/fiware-orion/issues/4125) を参照)。
+
+`FeatureCollection` に関しては、単一の `Feature` が含まれている場合 (つまり、`features` フィールドに要素が1つしかない場合) にのみ、
+作成/更新時に受け入れられます。それ以外の場合、Orion は `BadRequest` エラーを返します。
+
+まったくサポートされていない GeoJSON タイプは GeometryCollection だけです。それらを使用しようとすると、"Database Error" が発生します。
 
 [トップ](#top)
 

doc/manuals/user/ngsiv2_implementation_notes.md

@@ -249,7 +249,7 @@ With regards to `FeatureCollection`, it is only accepted at creation/update time
 `Feature` (i.e. the `features` field has only one element). Otherwise , Orion would return an `BadRequest`error.
 
 The only GeoJSON type not supported at all is `GeometryCollection`. You will get a "Database Error"
-if you try to use them).
+if you try to use them.
 
 ## Legacy attribute format in notifications