File Format
一个pbf文件通常包括一个文件头和一系列的文件体。这种设计是为了以后文件随机读取，并且跳过不理解或者不需要的数据。
文件格式由以下部分组成：
int4: 以网络字节顺序排列的BlobHeader长度
BlobHeader: 定义如下
message BlobHeader {
required string type = 1;类型
optional bytes indexdata = 2;索引信息（OSM中为bounding box）
required int32 datasize = 3; Blob消息的序列化大小
}
Blob，通过未压缩或者以zlib/deflat进行压缩格式，存储数据blob信息
message Blob {
optional bytes raw = 1; // 不压缩
optional int32 raw_size = 2; // 压缩时解压大小
optional bytes zlib_data = 3; // 数据压缩版本
optional bytes lzma_data = 4;//LZMA数据压缩特征
optional bytes OBSOLETE_bzip2_data = 5 [deprecated=true]; // Don't reuse this tag number.
}
目前OSM数据有两种文件体类型，实际的类型信息存储在BlobHeader的type字段中：
OSMHeader，包含了HeaderBlock信息。在首个OSMData前，每个文件体必须有这些中的一个。
OSMData，包含了序列化之后的PrimitiveBlock信息，包含了实体信息。
这种设计便于用户根据自己的需要扩展类型信息，解析时应当忽略或者跳过无法识别的类型。
OSMHeader文件块定义：
message HeaderBlock {
optional HeaderBBox bbox = 1;//bounding box
/* 解析数据集附加标签说明 */
repeated string required_features = 4;
repeated string optional_features = 5;
optional string writingprogram = 16;
optional string source = 17; // From the bbox field.
/* Tags that allow continuing an Osmosis replication */
// replication timestamp, expressed in seconds since the epoch,
// otherwise the same value as in the "timestamp=..." field
// in the state.txt file used by Osmosis
optional int64 osmosis_replication_timestamp = 32;
// replication sequence number (sequenceNumber in state.txt)
optional int64 osmosis_replication_sequence_number = 33;
// replication base URL (from Osmosis' configuration.txt file)
optional string osmosis_replication_base_url = 34;
}
为了提供前后兼容性，解析器需要知道文件能否被解析。判断能否被解析是通过required features（必须要素）实现的，如果一个文件的必须要素中包含了解析器无法识别字段，则该文件无法解析，返回错误信息，并报告无法解析字段。
目前已定义的要素有：
OsmSchema-V0.6：OSM v0.6标准的数据
DenseNodes：文件包含密集节点和密集信息
HistoricalInformation：文件包含OSM历史信息
OSMData文件块定义：
message PrimitiveBlock {
required StringTable stringtable = 1;
repeated PrimitiveGroup primitivegroup = 2;
optional int32 granularity= 17[default=100];//坐标存储精度
optional int64 lat_offset = 19 [default=0]; // 坐标偏差.
optional int64 lon_offset = 20 [default=0];
// 时间精度
optional int32 date_granularity = 18 [default=1000];
// Proposed extension:
//optional BBox bbox = XX;
}
创建PBF文件时，需要提取所有的字符串（key，value，role，user）到单独的string table中。
一个PrimitiveGroup不会包含不同种类的对象。可以包含Node、DenseNode、Way、Relation、ChangeSet信息，但是不能同时包含两种及以上。