Add page_size argument to arc_select()

[JosiahParry]

Checklist

• update NEWS.md
• documentation updated with devtools::document()
• devtools::check() passes locally

Changes

This PR adds a page_size argument to arc_select() which permits us to have more control over the total number of features that are returned on a per-request basis. This will allow us to overcome the issue of timeouts with dense geometries.

Closes

• closes New argument batch_size #141

Follow up tasks

• Create docs on working with dense geometries. This doc will tell users how to utilize the batch_size argument to increase the number of requests made and reduce the number of features per page.

[JosiahParry]

Relatedly, this will let us close #138 as it gives us a working solution to the problem. It will not be automagical but it will be doable!

[JosiahParry]

@mmachir could you please review and test when you get a chance? To install you can run:

# get the most recent dev version of {arcgisutils} if it hasn't
#  been updated since token overhaul
pak::pak("r-arcgis/arcgisutils")

# install branch:
pak::pak("r-arcgis/arcgislayers@batch_size")

[mmachir]

page size argument is looking good!

library(arcgislayers)
library(arcgisutils)

# test dense geometries
url <- 'https://ags.esri.co/arcgis/rest/services/DatosAbiertos/ELECCIONES_PRESIDENCIALES_2014_MPIO/MapServer/0'

# original approach
data <- arc_read(url)
#> Warning in parse_esri_json(httr2::resp_body_string(x)): Status code: 500
#> Error: Error performing query operation

# new approach
x <- arc_open(url)
res <- arc_select(x, n_max = 25, page_size = 5)

res1 <- arc_read(url, n_max=1000, page_size = 5)
#> Iterating ■■ 4% | ETA: 24sIterating ■■ 4% | ETA: 28sIterating ■■■ 6% | ETA:
#> 27sIterating ■■■ 8% | ETA: 23sIterating ■■■ 8% | ETA: 24s
...
#> ■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■ 100% | ETA: 0s
res1
#> Simple feature collection with 1000 features and 12 fields
#> Geometry type: MULTIPOLYGON
#> Dimension:     XY
#> Bounding box:  xmin: -9098782 ymin: -471076.2 xmax: -7441413 ymax: 1504842
#> Projected CRS: WGS 84 / Pseudo-Mercator
#> First 10 features:
#>    OBJECTID DPTO_CCDGO MPIO_CCDGO    DEPTO             MUNICIPIO COD_MUNICI
#> 1         1         94        887  GUAINIA             PANA PANA        887
#> 2         2         91        540 AMAZONAS         PUERTO NARIÑO        540
#> 3         3         95        001 GUAVIARE SAN JOSE DEL GUAVIARE        001
#> 4         4         86        749 PUTUMAYO              SIBUNDOY        749
...

^{Created on 2024-02-14 with reprex v2.1.0}