如何使用knitr在PDF中正确渲染mapview地图输出？

mapview本身是为交互式HTML输出设计的，直接在PDF里渲染时，R Markdown会通过快照方式捕获地图，但很容易因为渲染延迟导致比例失调、图例丢失、不遵循fig.width设置这类问题。以下是两种可行的解决办法：

方法一：改用静态绘图包（推荐） #

用专门的静态地图绘图包（比如tmap或ggplot2）替代mapview，这类包原生支持PDF输出，能严格遵循绘图尺寸设置，且渲染稳定。

示例代码：

---
title: "test"
output:
  pdf_document: default
  html_document: default
date: "2024-04-27"
---

## Static Map for PDF
```{r tmap, fig.width=2, fig.height=2}
library(tmap)
library(sf)
data(breweries)

# 绘制静态地图，控制尺寸和图例
tm_shape(breweries) +
  tm_dots(size = 0.2, col = "darkred") +
  tm_layout(legend.position = "right", frame = FALSE, legend.title.size = 0.8)

## 方法二：将mapview转为静态图片输出
如果必须使用mapview，可以用`mapshot`函数把交互式地图转为静态图片，再插入到PDF中，避免快照延迟问题。

示例代码：
```yaml
---
title: "test"
output:
  pdf_document: default
  html_document: default
date: "2024-04-27"
---

## Mapview as Static Image
```{r mapview-pdf, fig.width=2, echo=FALSE, warning=FALSE}
library(mapview)
library(sf)
library(magick)

# 创建mapview对象
mv_map <- mapview(breweries, legend = TRUE)

# 保存为临时图片，移除交互控件
temp_img <- tempfile(fileext = ".png")
mapshot(mv_map, file = temp_img, remove_controls = c("zoom", "home", "layers"))

# 读取并输出图片
img <- image_read(temp_img)
print(img)

### 关键说明
- mapview的交互特性和PDF的静态输出天然不兼容，直接渲染容易出现各种异常；
- 静态绘图包能保证PDF输出的一致性和可控性，是更可靠的选择；
- 用`mapshot`转图片时，可通过`remove_controls`参数去掉不需要的交互按钮，让图片更简洁。

内容的提问来源于stack exchange，提问作者M. Beausoleil