RFC 8142 - GeoJSON Text Sequences 日本語訳

原文URL : https://datatracker.ietf.org/doc/html/rfc8142
タイトル : RFC 8142 - GeoJSONテキストシーケンス
翻訳編集 : 自動生成

[要約] RFC 8142は、GeoJSONテキストシーケンスの形式と目的を定義しています。GeoJSONデータを効率的に処理するために、複数のGeoJSONオブジェクトを1つのテキストシーケンスにまとめることができます。

Internet Engineering Task Force (IETF)                        S. Gillies
Request for Comments: 8142                                        Mapbox
Category: Standards Track                                     April 2017
ISSN: 2070-1721

GeoJSON Text Sequences

GeoJSONテキストシーケンス

Abstract

概要

This document describes the GeoJSON text sequence format and "application/geo+json-seq" media type. This format is based on JavaScript Object Notation (JSON) text sequences and GeoJSON, and it makes arbitrarily large geographic datasets incrementally parseable without restricting the form of GeoJSON texts within a sequence.

このドキュメントでは、GeoJSONテキストシーケンス形式と「application / geo + json-seq」メディアタイプについて説明します。この形式はJavaScript Object Notation（JSON）テキストシーケンスとGeoJSONに基づいており、シーケンス内のGeoJSONテキストの形式を制限することなく、任意の大きな地理データセットを段階的に解析できます。

Status of This Memo

本文書の状態

This is an Internet Standards Track document.

これはInternet Standards Trackドキュメントです。

This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841.

このドキュメントは、IETF（Internet Engineering Task Force）の製品です。これは、IETFコミュニティのコンセンサスを表しています。公開レビューを受け、インターネットエンジニアリングステアリンググループ（IESG）による公開が承認されました。インターネット標準の詳細については、RFC 7841のセクション2をご覧ください。

Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc8142.

このドキュメントの現在のステータス、エラータ、およびフィードバックの提供方法に関する情報は、http：//www.rfc-editor.org/info/rfc8142で入手できます。

著作権表示

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.

この文書は、BCP 78およびこの文書の発行日に有効なIETF文書に関するIETFトラストの法的規定（http://trustee.ietf.org/license-info）の対象となります。これらのドキュメントは、このドキュメントに関するあなたの権利と制限を説明しているため、注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、Trust Legal Provisionsのセクション4.eに記載されているSimplified BSD Licenseのテキストが含まれている必要があり、Simplified BSD Licenseに記載されているように保証なしで提供されます。

Table of Contents

   1. Introduction ....................................................2
      1.1. Requirements Language ......................................2
   2. GeoJSON Text Sequence Format ....................................2
   3. Security Considerations .........................................3
   4. Interoperability Considerations .................................3
   5. IANA Considerations .............................................3
   6. References ......................................................4
      6.1. Normative References .......................................4
      6.2. Informative References .....................................5
   Author's Address ...................................................5

1. Introduction

1. はじめに

Arbitrarily large sequences of values pose a problem for JavaScript Object Notation (JSON) [RFC7159] that is well explained in the motivation for JSON text sequences [RFC7464]. The GeoJSON format [RFC7946] faces the same kind of problem. Geographic datasets often run to the tens of thousands or millions of features. The problem is often amplified by the presence of large arrays of coordinates for each of the features.

値のシーケンスが任意に大きいと、JavaScript Object Notation（JSON）[RFC7159]で問題が発生します。これは、JSONテキストシーケンスの動機[RFC7464]で詳しく説明されています。 GeoJSON形式[RFC7946]も同じ種類の問題に直面しています。多くの場合、地理データセットは数万または数百万のフィーチャに実行されます。多くの場合、問題は、各フィーチャの座標の大きな配列の存在によって増幅されます。

This document describes a specialization of JSON text sequences. A GeoJSON text sequence is a document of arbitrarily large size containing one or more GeoJSON objects (e.g., multiple GeoJSON texts that can be produced and parsed incrementally) and not just a single GeoJSON FeatureCollection, Feature, or Geometry.

このドキュメントでは、JSONテキストシーケンスの特殊化について説明します。 GeoJSONテキストシーケンスは、単一のGeoJSON FeatureCollection、Feature、またはGeometryだけでなく、1つ以上のGeoJSONオブジェクト（たとえば、増分的に生成および解析できる複数のGeoJSONテキスト）を含む任意のサイズのドキュメントです。

1.1. Requirements Language

1.1. 要件言語

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119].

キーワード「MUST」、「MUST NOT」、「REQUIRED」、「SHALL」、「SHALL NOT」、「SHOULD」、「SHOULD NOT」、「RECOMMENDED」、「NOT RECOMMENDED」、「MAY」、「OPTIONALこの文書の "は、[RFC2119]で説明されているように解釈されます。

2. GeoJSON Text Sequence Format

2. GeoJSONテキストシーケンス形式

Defined in prose similar to the description of the JSON text sequence in [RFC7464], a GeoJSON text sequence is any number of GeoJSON [RFC7946] texts, each encoded in UTF-8 [RFC3629], preceded by one ASCII [RFC20] record separator (RS) character, and followed by a line feed (LF).

[RFC7464]のJSONテキストシーケンスの説明と同様に文章で定義されたGeoJSONテキストシーケンスは、任意の数のGeoJSON [RFC7946]テキストで、それぞれUTF-8 [RFC3629]でエンコードされ、1つのASCII [RFC20]レコードセパレータが前に付きます。（RS）文字の後に改行（LF）が続きます。

The GeoJSON text sequence format conforms to all the rules of [RFC7464] and adds the following constraint: each JSON text MUST contain a single GeoJSON object as defined in [RFC7946].

GeoJSONテキストシーケンス形式は、[RFC7464]のすべてのルールに準拠し、次の制約を追加します。各JSONテキストには、[RFC7946]で定義されている単一のGeoJSONオブジェクトを含める必要があります。

Heterogeneous sequences containing a mix of GeoJSON Geometry, Feature, and FeatureCollection objects are permitted. How producers and parsers of GeoJSON text sequences communicate rules for allowed GeoJSON types in exchanged sequences is not specified in this document.

GeoJSON Geometry、Feature、およびFeatureCollectionオブジェクトの混合を含む異種シーケンスは許可されます。このドキュメントでは、GeoJSONテキストシーケンスのプロデューサーとパーサーが、交換されたシーケンスで許可されているGeoJSONタイプのルールをどのように伝達するかについては説明していません。

3. Security Considerations

3. セキュリティに関する考慮事項

GeoJSON text sequences have no security considerations beyond those of JSON text sequences [RFC7464] and the GeoJSON format [RFC7946].

GeoJSONテキストシーケンスには、JSONテキストシーケンス[RFC7464]およびGeoJSON形式[RFC7946]を超えるセキュリティ上の考慮事項はありません。

4. Interoperability Considerations

4. 相互運用性に関する考慮事項

The advantage of using ASCII character RS "0x1e" to denote a text is that sequence producers and parsers need not enforce a canonical form of GeoJSON. Any valid GeoJSON, pretty-printed or compact, can be used in a GeoJSON text sequence.

ASCII文字RS "0x1e"を使用してテキストを示すことの利点は、シーケンスプロデューサーとパーサーが標準形式のGeoJSONを適用する必要がないことです。有効なGeoJSONは、きれいに印刷されたものでもコンパクトなものでも、GeoJSONテキストシーケンスで使用できます。

A variety of parsers designed for newline-delimited sequences of compact JSON text are deployed on the internet today. While there is no canonical form for JSON texts, and pretty-printed and compact forms are equally valid, GeoJSON text sequences containing compact GeoJSON texts with no internal newlines are more interoperable with existing non-standardized parsers.

改行で区切られたコンパクトなJSONテキストのシーケンス用に設計されたさまざまなパーサーが、今日インターネットに配備されています。 JSONテキストの標準形式はなく、きれいに印刷されたフォームとコンパクトフォームも同様に有効ですが、内部改行のないコンパクトなGeoJSONテキストを含むGeoJSONテキストシーケンスは、既存の標準化されていないパーサーと相互運用できます。

In a distributed system where order and exactly-once delivery of messages are difficult to achieve, GeoJSON text sequences that do not rely on order of texts for extra semantics are more interoperable than those that do.

メッセージの順序と正確に1回の配信を実現することが困難な分散システムでは、余分なセマンティクスについてテキストの順序に依存しないGeoJSONテキストシーケンスは、それよりも相互運用性が高くなります。

5. IANA Considerations

5. IANAに関する考慮事項

The MIME media type for GeoJSON text sequences is "application/ geo+json-seq" (which uses the suffix established in [RFC8091]). IANA has registered it in the "Media Types" registry <https://www.iana.org/assignments/media-types/>.

GeoJSONテキストシーケンスのMIMEメディアタイプは「application / geo + json-seq」です（[RFC8091]で確立されたサフィックスを使用しています）。 IANAはこれを「メディアタイプ」レジストリ<https://www.iana.org/assignments/media-types/>に登録しました。

Type name: application

タイプ名：アプリケーション

Subtype name: geo+json-seq

サブタイプ名：geo + json-seq

Required parameters: n/a

必須パラメーター：なし

Optional parameters: n/a

オプションのパラメーター：n / a

Encoding considerations: binary

エンコーディングに関する考慮事項：バイナリ

Security considerations: See Section 3 of RFC 8142 Interoperability considerations: See Section 4 of RFC 8142

セキュリティの考慮事項：RFC 8142のセクション3を参照してください相互運用性の考慮事項：RFC 8142のセクション4を参照してください

Published specification: RFC 8142

公開された仕様：RFC 8142

Applications that use this media type: Geographic information systems (GIS)

このメディアタイプを使用するアプリケーション：地理情報システム（GIS）

Additional information:

追加情報：

Deprecated alias names for this type: n/a

このタイプの非推奨のエイリアス名：n / a

      Magic number(s):  n/a

      File extension(s):  n/a

      Macintosh file type code(s):  n/a

Person to contact for further information: Sean Gillies (sean.gillies@gmail.com)

詳細情報の連絡先：Sean Gillies（sean.gillies@gmail.com）

Intended usage: COMMON

使用目的：COMMON

Restrictions on usage: none

使用上の制限：なし

Author: Sean Gillies (sean.gillies@gmail.com)

作成者：Sean Gillies（sean.gillies@gmail.com）

Change controller: IETF

コントローラの変更：IETF

6. References

6. 参考文献

6.1. Normative References

6.1. 引用文献

[RFC20] Cerf, V., "ASCII format for network interchange", STD 80, RFC 20, DOI 10.17487/RFC0020, October 1969, <http://www.rfc-editor.org/info/rfc20>.

[RFC20] Cerf、V。、「ネットワーク交換用のASCII形式」、STD 80、RFC 20、DOI 10.17487 / RFC0020、1969年10月、<http://www.rfc-editor.org/info/rfc20>。

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <http://www.rfc-editor.org/info/rfc2119>.

[RFC2119] Bradner、S。、「要件レベルを示すためにRFCで使用するキーワード」、BCP 14、RFC 2119、DOI 10.17487 / RFC2119、1997年3月、<http://www.rfc-editor.org/info/ rfc2119>。

[RFC3629] Yergeau, F., "UTF-8, a transformation format of ISO 10646", STD 63, RFC 3629, DOI 10.17487/RFC3629, November 2003, <http://www.rfc-editor.org/info/rfc3629>.

[RFC3629] Yergeau、F。、「UTF-8、ISO 10646の変換フォーマット」、STD 63、RFC 3629、DOI 10.17487 / RFC3629、2003年11月、<http://www.rfc-editor.org/info/ rfc3629>。

[RFC7159] Bray, T., Ed., "The JavaScript Object Notation (JSON) Data Interchange Format", RFC 7159, DOI 10.17487/RFC7159, March 2014, <http://www.rfc-editor.org/info/rfc7159>.

[RFC7159]ブレイ、T。、編、「JavaScript Object Notation（JSON）データ交換フォーマット」、RFC 7159、DOI 10.17487 / RFC7159、2014年3月、<http://www.rfc-editor.org/info/ rfc7159>。

[RFC7464] Williams, N., "JavaScript Object Notation (JSON) Text Sequences", RFC 7464, DOI 10.17487/RFC7464, February 2015, <http://www.rfc-editor.org/info/rfc7464>.

[RFC7464]ウィリアムズ、N。、「JavaScript Object Notation（JSON）Text Sequences」、RFC 7464、DOI 10.17487 / RFC7464、2015年2月、<http://www.rfc-editor.org/info/rfc7464>。

[RFC7946] Butler, H., Daly, M., Doyle, A., Gillies, S., Hagen, S., and T. Schaub, "The GeoJSON Format", RFC 7946, DOI 10.17487/RFC7946, August 2016, <http://www.rfc-editor.org/info/rfc7946>.

[RFC7946]バトラー、H。、デーリー、M。、ドイル、A。、ギリーズ、S。、ハーゲン、S。、およびT.シャウブ、「GeoJSON形式」、RFC 7946、DOI 10.17487 / RFC7946、2016年8月、 <http://www.rfc-editor.org/info/rfc7946>。

6.2. Informative References

6.2. 参考引用

[RFC8091] Wilde, E., "A Media Type Structured Syntax Suffix for JSON Text Sequences", RFC 8091, DOI 10.17487/RFC8091, February 2017, <http://www.rfc-editor.org/info/rfc8091>.

[RFC8091]ワイルド、E。、「JSONテキストシーケンスのメディアタイプ構造化構文サフィックス」、RFC 8091、DOI 10.17487 / RFC8091、2017年2月、<http://www.rfc-editor.org/info/rfc8091>。

Author's Address

著者のアドレス

Sean Gillies Mapbox

   Email: sean.gillies@gmail.com
   URI:   http://sgillies.net