PBDB Data Service：Single fossil collection（单一化石采集记录）

描述

此操作返回有关单个集合的信息，该集合由其标识符选择。

用法

• /data1.2/colls/single.json?id=50068&show=loc,stratext

{
"elapsed_time":0.0014,
"records": [
{"oid":"col:50068","sfm":"San Mateo","lng":-117.366669,"lat":33.200001,"nam":"Lawrence Canyon 3","aka":"LACM 4301, UCMP V68106, SDSNH 2643","noc":34,"oei":"Zanclean","eag":5.333,"lag":3.6,"rid":"ref:13448","cc2":"US","stp":"California","cny":"San Diego","prc":"__","gsc":"outcrop","sfm":"San Mateo","ssc":"formation","scm":"Hemphillian: Domning (1978) states the age of this collection is \"Middle Pliocene\""}
]
}

参数

以下必需参数选择要检索的记录

• coll_id：要检索的集合的标识符（必需）。您可以改用参数名称 id。

以下参数指定应返回其他数据块以及基本收集记录。

您还可以使用以下参数来指定要检索的信息

• pgm：指定估算古坐标时使用的古地理模型。您可以从以下模型中选择其一或选择多个（用逗号分隔）。如果您没有指定此参数，默认模型是gplates。
  1. gplates：Wright et. al., 2013; Towards community-driven paleogeographic reconstructions
  2. scotese：Scotese, C.R., 2021. An Atlas of Paleogeographic Maps: The Seas Come In and the Seas Go Out, Annual Reviews of Earth and Planetary Sciences, v. 49, p. 669-718.
  3. seton：Seton et. al., 2012; Global continental and ocean basin reconstructions since 200 Ma

• show：此参数用于选择要返回的其他信息块以及每个集合的基本记录。其值应为以下一项或多项，以逗号分隔：
  full：这是包含定义此记录的所有信息的快捷方式。目前，这包括以下块：attr, loc, paleoloc, prot, stratext, lithext, geo, ctaph, comps, methods, rem, refattr。如果我们稍后将新的数据字段添加到集合记录中，这些字段将包含在此块中。因此，如果要发布 URL，最好包含 show=full。
  loc：有关采集记录地理位置的其他信息
  bin：集合所属的地理群集的列表。
  paleoloc：有关集合的古地理位置的信息，根据参数 pgm 指定的模型进行评估。
  prot：指明采集记录是否在受保护的土地上
  time：此块包括导航器需要的字段“cx_int_no”。
  timebins：显示临时条柱的列表，根据为此请求选择的时间规则，每个匹配项都属于这些时间箱。您可以使用时间规则参数选择一个，或者默认为专业。
  timecompare：与timebins类似，但显示所有可用时间规则的此信息。
  strat：有关该系列地层背景的基本信息。
  stratext：有关收集的地层背景的详细信息。这包括来自 strat 的所有信息以及额外的字段。
  lith：有关该系列岩性背景的基本信息。
  lithext：有关该系列岩性背景的详细信息。这包括来自 lith 的所有信息以及额外的字段。
  env：与此集合相关的古环境。
  geo：有关采集记录地质背景的信息（包括环境）。
  ctaph：有关采集的埋葬学和组成化石的保存方式的信息。
  comps：有关作为此集合的一部分发现的各种身体部位和其他事物的信息。
  methods：有关所用收集方法的信息
  resgroup：与此采集记录相关的研究小组（如果有）。
  ref：集合的主要引用，作为格式化文本。
  refattr：采集记录主要参考文献的作者和出版年份。
  secref：包括集合的辅助引用的标识符。
  ent：授权、输入和修改此记录的人员的标识符
  entname：授权、输入和修改此记录的人员的姓名
  crmod：收集记录的创建和修改时间戳

当然还可以使用任何特殊参数，请参阅PBDB Data Service：Special parameters（特殊参数）。

方法

这个数据服务接受以下HTTP方法：GET，HEAD。

响应结果

使用此操作对HTTP请求的响应将包含以下列表中的字段。区块basic是一直显示的。其他的可以使用参数show来选择。

1. basic

字段名（pbdb）	字段名（com）	描述
collection_no	oid	集合的唯一标识符。如果结果格式为 JSON，这将是一个字符串。为了向后兼容，文本格式结果中的所有标识符将继续为整数。
record_type	typ	此对象的类型
permissions	prm	此记录的可访问性。如果为空，则记录是公共的。否则，此记录的值将是以下值之一：members——只有数据库成员才能访问该记录。authorizer——该记录可供其授权方组以及授予权限的任何其他授权方组访问。group(…)——该记录仅供指定研究小组的成员访问。
formation	sfm	发现藏品的地层
lng	lng	集合所在的经度（以度为单位）
lat	lat	集合所在的纬度（以度为单位）
collection_name	nam	标识集合的名称，不一定是唯一的
collection_subset	nm2	如果集合是另一个集合的一部分，则此字段指定哪个部分
collection_aka	aka	集合的备用名称或有关集合的其他说明。
n_occs	noc	集合中的出现次数
early_interval	oei	与集合关联的特定地质时间范围（不一定是标准间隔），或者如果还给出了late_interval则开始范围的间隔
late_interval	oli	结束与集合关联的特定地质时间范围的间隔
max_ma	eag	与此集合相关的地质时间范围的早期界限（以Ma为单位）
min_ma	lag	与此集合相关的地质时间范围的后期界限（以 Ma 为单位）
reference_no	rid	从中输入此数据的主引用的标识符。

2. refattr

字段名（pbdb）	字段名（com）	描述
ref_author	aut	馆藏的署名（作者和年份）
ref_pubyr	pby	该系列出版的年份

3. secref

字段名（pbdb）	字段名（com）	描述
reference_nos	rfs	与此集合关联的所有引用的标识符列表。通常，这些引用包括主引用以及从中输入出现项的任何其他引用。

4. loc

字段名（pbdb）	字段名（com）	描述
cc	cc2	馆藏所在的国家/地区，编码为 ISO-3166-1 alpha-2
state	stp	馆藏所在的州或省（如果已知）
county	cny	馆藏所在的县或市辖区（如果已知）
latlng_basis	n/a	报告集合位置的基础。参阅坐标的基础和精度
latlng_precision	n/a	化石记录坐标的精度。按上面的链接查看代码值列表。
n/a	prc	表示地理坐标的基础和精度的两字母代码。在使用紧凑术语表的响应中，将报告此字段，而不是latlng_basis和latlng_precision。按上面的链接查看代码值列表。
geogscale	gsc	化石记录的地理刻度
geogcomments	ggc	关于化石记录地理位置的附加注释

5：bin

字段名（pbdb）	字段名（com）	描述
bin_id_3	lv3	化石记录或集群所在的三级集群的标识
bin_id_2	lv2	化石记录或集群所在的二级集群的标识
bin_id_1	lv1	化石记录或集群所在的一级集群的标识

6：paleoloc

字段名（pbdb）	字段名（com）	描述
paleomodel	pm1	由参数pgm指定的主要模型。此字段仅在指定多个模型时包含。
geoplate	gpl	根据参数pgm所表示的初级模型来评价化石记录所在的地质板块的标识符。这可能是一个数字或一个字符串。
paleoage	ps1	指示这些古坐标是否在每个化石记录的年龄范围的早期、中期或晚期计算
paleolng	pln	根据参数pgm*所表示的原始模型，对化石记录的古经度进行了计算。
paleolat	pla	根据参数pgm表示的原始模型，对化石记录的古纬度进行了计算。
paleoage_b	ps1_b	交互年龄选择器
paleolng_b	pln_b	对应于交互年龄选择器的古经度
paleolat_b	pla_b	对应于交互年龄选择器的古纬度
paleoage_c	ps1_c	交互年龄选择器
paleolng_c	pln_c	对应于交互年龄选择器的古经度
paleolat_c	pla_c	对应于交互年龄选择器的古纬度
paleomodel2	pm2	由参数pgm指定的替代模型。此字段仅在指定多个模型时包含。也可能有paleomodel3等。
geoplate2	gp2	一个替代的地质板块标识符，如果pgm参数表明一个以上的模型。也可能有geoplate3等。
paleoage2	ps2	指示第二个古坐标是在每个化石记录的早期、中期还是晚期计算的
paleolng2	pln2	如果pgm*参数表明有多个模型，则为集合提供一个替代的古经线。也可能有paleolng3等。
paleolat2	pla2	如果pgm参数表明有多个模型，则为集合提供一个替代的古纬度。也可能有paleolat3等。
paleoage2_b	ps2_b	交互年龄选择器
paleolng2_b	pln2_b	对应于交互年龄选择器的古经度
paleolat2_b	pla2_b	对应于交互年龄选择器的古纬度
paleoage2_c	ps2_c	交互年龄选择器
paleolng2_c	pln2_c	对应于交互年龄选择器的古经度
paleolat2_c	pla2_c	对应于交互年龄选择器的古纬度

7：prot

字段名（pbdb）	字段名（com）	描述
cc	cc2	该化石记录所在的国家，编码为ISO-3166-1 alpha-2
protected	ptd	化石记录所在土地的受保护状态(如已知)。

8：time

字段名（pbdb）	字段名（com）	描述
cx_int_no	cxi	所选时间尺度中覆盖与化石记录或集群关联的整个时间范围的最特定的单个间隔的标识符。

9：timebins

字段名（pbdb）	字段名（com）	描述
time_bins	tbl	根据为此操作选择的时间规则，将此化石记录或集合放置到其中的时间间隔列表。您可以通过包含datainfo参数来查看选择了哪条规则。值为 - 表示时间范围太大，无法匹配该时间规则下的任何bin。

10：timecompare

字段名（pbdb）	字段名（com）	描述
time_contain	tbc	根据contain时间规则，将化石记录或集合放置到其中的时间间隔列表，或者 - 如果范围太大。
time_major	tbm	根据major时间规则，将化石记录或集合放置到其中的时间间隔列表，或者 - 如果范围太大。
time_buffer	tbb	根据buffer时间规则，将化石记录或集合放置到其中的时间间隔列表，或者 - 如果范围太大。
time_overlap	tbo	根据overlap时间规则，将化石记录或集合放置到其中的时间间隔列表

11：strat

字段名（pbdb）	字段名（com）	描述
formation	sfm	化石记录所在的地层（如果已知）
stratgroup	sgr	化石记录所在的地层组（如果已知）
member	smb	化石记录所在的地层成员（如果已知）

12：stratext

字段名（pbdb）	字段名（com）	描述
stratscale	ssc	该采集记录涵盖的地层范围
zone	szn	采集记录所在的地层带（如果已知）
localsection	stratext	采集记录所在的地层部分（如果已知）
localbed	slb	采集记录所在的岩床（如果已知）
localbedunit	slu	计算岩床时使用的计量单位
localorder	slo	描述当地岩床的顺序（如果已知）
regionalsection	srs	采集记录所在的局部地层（如果已知）
regionalbed	srb	采集记录所在的局部岩床（如果已知）
regionalbedunit	sru	计算局部岩床时使用的计量单位
regionalorder	sro	描述局部岩床的顺序（如果已知）
stratcomments	scm	关于采集记录地层背景的其他评论（如果有的话）

13：lith

字段名（pbdb）	字段名（com）	描述
lithdescript	ldc	对采集记录地点岩性方面的详细说明
lithology1	lt1	为采集记录地点描述的第一个岩性;该数据库每个化石记录最多可以代表两种不同的岩性
lithification1	lf1	为该遗址描述的第一个岩性的岩化状态
minor_lithology1	lm1	与该遗址描述的第一个岩性相关的次要岩性
lithology2	lt2	为采集地点描述的第二种岩性（如果有）
lithification2	lf2	为该地点描述的第二岩性的岩化状态。有关值，请参见上文。
minor_lithology2	lm2	与该遗址描述的第二种岩性相关的次要岩性（如果有的话）

14：lithext

字段名（pbdb）	字段名（com）	描述
lithadj1	la1	描述第一种岩性的形容词
fossilsfrom1	ff1	化石是否取自第一个描述的岩性
lithadj2	la2	描述第二岩性的形容词（如果有的话）
fossilsfrom2	ff2	化石是否取自第二个描述的岩性

15：env

字段名（pbdb）	字段名（com）	描述
environment	env	与采集地点相关的古环境

16：geo

字段名（pbdb）	字段名（com）	描述
environment	env	采集遗址的古环境
tectonic_setting	tec	采集地点的构造环境
geology_comments	gcm	关于收集地点地质的一般评论

17：ctaph

字段名（pbdb）	字段名（com）	描述
pres_mode	tpm	该字段报告PBDB收集表上的“保存”选项卡中的保存，发生和矿化模式。
preservation_quality	tpq	保留了解剖细节的质量。
spatial_resolution	tps	保存信息的空间分辨率。
temporal_resolution	tpt	保存信息的时间分辨率。
lagerstatten	tpl	在此采集记录中找到的lagerstätten类型。
concentration	tpc	该收藏中发现的化石的丰度
orientation	tpo	该收藏中发现的化石的方向。
abund_in_sediment	tpa	沉积物丰度
sorting	tpr	尺寸排序程度
fragmentation	tpf	碎片化程度
bioerosion	tpb	生物侵蚀程度
encrustation	tpe	结壳程度
preservation_comments	pcm	保存注释（如果有）。

18：comps

字段名（pbdb）	字段名（com）	描述
assembl_comps	cps	在此采集记录中找到的大小类。此字段的值将是以下一项或多项：macrofossils, mesofossils, microfossils
articulated_parts	cpa	该采集记录中连接身体部位的丰度。
associated_parts	cpb	此采集记录中相关身体部位的丰度。
common_body_parts	cpc
rare_body_parts	cpd	此采集记录中罕见的身体部位列表。
feed_pred_traces	cpt	在此采集记录中找到的觅食/捕食痕迹的列表（如果有）。
artifacts	cpf	在此采集记录中找到的项目列表（如果有）。
component_comments	acm	组分的注释（如果有）

19：methods

字段名（pbdb）	字段名（com）	描述
collection_type	cct	化石记录的类型或用途。
collection_methods	ccx	所采用的一个或多个方法。
museum	ccu	收藏标本的博物馆。
collection_coverage	ccv	存在但未具体列出的化石。
collection_size	ccs	实际收集的化石数量。
rock_censused	ccr	岩石数量。
collectors	ccc	采集人的名字
collection_dates	ccd	收集完成的日期。
collection_comments	ccm	关于收集方法的评论。
taxonomy_comments	tcm	关于发现内容的分类的评论。

20：ref

字段名（pbdb）	字段名（com）	描述
primary_reference	ref	与此记录关联的主要引用（作为格式化文本）

21：resgroup

字段名（pbdb）	字段名（com）	描述
research_group	rgp	与此馆藏相关的研究小组（如果有）。

22：ent

字段名（pbdb）	字段名（com）	描述
authorizer_no	ati	授权输入此记录的人员的标识符
enterer_no	eni	实际输入此记录的人员的标识符。
modifier_no	mdi	上次修改此记录的人员的标识符（如果已修改）。

23：entname

字段名（pbdb）	字段名（com）	描述
authorizer_no	ati	授权输入此记录的人员的标识符
enterer_no	eni	实际输入此记录的人员的标识符。
modifier_no	mdi	上次修改此记录的人员的标识符（如果已修改）。
authorizer	ath	授权输入此记录的人员的姓名
enterer	ent	实际输入此记录的人员的姓名
modifier	mdf	上次修改此记录的人员的姓名（如果已修改）。

24：crmod

字段名（pbdb）	字段名（com）	描述
created	dcr	创建此记录的日期和时间。
modified	dmd	上次修改此记录的日期和时间。

格式

以下响应格式可用于此操作。必须通过向 URI 路径添加适当的后缀来为请求选择所需的格式。

格式	后缀	文档
JSON	.json	JSON format
Comma-separated text	.txt	Text formats
Comma-separated text	.csv	Text formats
Tab-separated text	.tsv	Text formats

术语表

术语表	名称	默认格式	描述
PaleobioDB field names	pbdb	txt, csv, tsv	PBDB词汇表来自数据库中的基础字段名和值，并增加了一些新字段。在大多数情况下，使用此词汇表的响应将直接与从PBDB Classic接口下载的响应相比较。此词汇表是Text格式响应的默认词汇。
Compact field names	com	json	Compact词汇表是一组3个字符的字段名，旨在将响应消息的大小最小化。这是JSON格式响应的默认值。一些字段值被类似地简化，而其他字段值则被完整地传递。