Contents

GeoSearchPagination

Pagination parameters for geo location search requests and responses.

Declaration

object GeoSearchPagination

Properties

NameTypeDescription
totalCountint64

Total number of results matching the search criteria. Present in the response only. Read-only.

offsetint32

Zero-based index of the first result to return. Defaults to 0.

pageSizeint32

Maximum number of results to return per page. Defaults to 20.

Discussion

The GeoSearchPagination object controls and reports offset-based pagination through geo location search results.

When used in a GeoSearchPostRequest body, set offset and pageSize to retrieve a specific page of results. The GET endpoint (GET /v1/search/geo (Search Geo Locations)) accepts offset and pageSize as query parameters instead of a request body. In both cases the response pagination object includes totalCount, enabling callers to calculate the total number of pages available.

The default pageSize of 20 is sufficient for most targeted lookups. Increase it for searches expected to return many matching locations. To retrieve the next page, increment offset by pageSize.

Example

{
  "totalCount": 87,
  "offset": 20,
  "pageSize": 20
}

See Also