[要約] この文書は、地理情報を表現するGeoJSONオブジェクトをストリームとして効率的に転送するための「GeoJSONテキストシーケンス」形式を定義しています。RFC 7464（JSONテキストシーケンス）の規則をGeoJSONに適用し、巨大な地理データセットを逐次的に解析可能にすることで、パースエラーに強い構造でのリアルタイムな位置情報交換や大規模データ処理を支援します。
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.
これはインターネット標準化過程の文書です。
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.
このドキュメントは、Internet Engineering Task Force (IETF) の成果物です。これは、IETFコミュニティのコンセンサスを表しています。この文書は公開レビューを受け、Internet Engineering Steering Group (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 で入手できます。
Copyright Notice
著作権表示
Copyright (c) 2017 IETF Trust and the persons identified as the document authors. All rights reserved.
Copyright（c）2017 IETF Trustおよびドキュメントの作成者として識別された人物。全著作権所有。
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
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] も同様の問題に直面しています。地理データセットは、数万から数百万ものフィーチャ (Feature) に及ぶことがよくあります。この問題は、各フィーチャに巨大な座標配列が含まれていることで、さらに増幅されることがよくあります。
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 テキスト）を含む、任意のサイズのドキュメントです。
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] で説明されているように解釈されるものとします。
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 オブジェクトを含まなければなりません (MUST)。
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 テキストシーケンスの生成側 (Producer) と解析側 (Parser) が、交換されるシーケンス内で許可される GeoJSON タイプのルールをどのように伝達するかについては、このドキュメントでは規定していません。
GeoJSON text sequences have no security considerations beyond those of JSON text sequences [RFC7464] and the GeoJSON format [RFC7946].
GeoJSON テキストシーケンスには、JSON テキストシーケンス [RFC7464] および GeoJSON 形式 [RFC7946] の範囲を超えるセキュリティ上の考慮事項はありません。
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 の正規形式を強制する必要がないことです。整形された形式 (pretty-printed) でもコンパクトな形式でも、有効な 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回限りの配信 (exactly-once delivery) を実現することが困難な分散システムでは、追加のセマンティクスのためにテキストの順序に依存しない GeoJSON テキストシーケンスの方が、順序に依存するものよりも相互運用性が高くなります。
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 はこれを「Media Types」レジストリ <https://www.iana.org/assignments/media-types/> に登録しました。
Type name: application
タイプ名: application
Subtype name: geo+json-seq
サブタイプ名: geo+json-seq
Required parameters: n/a
必須パラメータ: なし
Optional parameters: 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
このタイプに対する非推奨の別名: なし
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
[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>。
[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
Sean Gillies Mapbox
Email: sean.gillies@gmail.com
URI: http://sgillies.net