R语言【rgbif】——什么是多值传参？如何在rgbif中一次性传递多个值？多值传参时的要求有哪些？

rgbif版本：3.7.8.1

什么是多值传参？

您是否在使用rgbif时设想过，给某个参数一次性传递许多个值，它将根据这些值独立地进行请求，各自返回独立的结果。

rgbif支持这种工作模式，但是具体的细节需要进一步地学习才能掌握，避免在使用时出现事与愿违的结果。

如何在rgbif中一次性传递多个值？

在使用rgbif的方法时，向某个参数传入多个值，用户的表达语句差之毫厘，代码结果就会失之千里。

比如说下面的两行代码，以向量类型传入两个值，它们会分别为taxonKey=1和taxonKey=212发出独立的请求：

c <- occ_search(taxonKey=c(1,212))
d <- occ_data(taxonKey=c(1,212))

返回的结果是将两次独立请求的结果组成的列表。

而如果传入的两个值变为一整条字符串时，它们不会认为要进行两次独立的请求，比如说：

c1 <- occ_search(taxonKey="1;212"))
d1 <- occ_data(taxonKey="1;212"))

故而结果也是一次独立请求返回的：

多值传参时的要求有哪些？

通过上面的示例，您可能对于rgbif支持的多值传参有了初步了解。但还远远不够，您有必要知道更多有关多值传参的信息。

以occ_search为例，某些参数可以接受将多个值组成向量c("a","b")，这样向量中的每个值都会发起一次独立的请求；而另外一些参数接受多个值组成一个由分号分隔的字符串"a;b"，这样只会发起一次请求。

尤其要注意的一点是，在每次独立的请求中，只能有一个参数是多值的。因此，在使用occ_search时，可以同时传入一个向量型多值参数和一个字符串型多值参数，也可以单独传入一个向量型多值参数或一个字符串型多值参数。下面通过2个例子说明：

第一种情况是同时传入一个向量型多值参数和一个字符串型多值参数，譬如：

e <- occ_search(taxonKey="1;2",basisOfRecord = c("PRESERVED_SPECIMEN","LIVING_SPECIMEN","MATERIAL_CITATION"))

第二种情况是一个向量型多值参数或字符串型多值参数，譬如：

f <- occ_search(occurrenceStatus=c("PRESENT","ABSENT"))

首先，您要清楚自己想要发起怎样的请求，然后根据两种不同传参的格式，谨慎地敲出代码，最后在预期的结果框架下进行分析。

occ_search()支持的多值传参

除了下面列出的参数，occ_search()的其余所有参数都支持多值传参：

• hasCoordinate
• hasGeospatialIssue
• occurrenceStatus
• search
• repatriated
• isInCluster
• limit
• offset

occ_search()的参数详情