Class MapLayerQueryBuilder

Fluent builder for constructing MapLayerQueryRequest objects.

Create via MapLayerQueryBuilder.from(serviceId, layerId) (standalone) or MapLayerQueryBuilder.for(client, serviceId, layerId) (bound to a client for .run()).

Example

// Standalone — build request object
const req = MapLayerQueryBuilder.from("myService", 0)
  .where("POP > 1000")
  .outFields("NAME", "POP")
  .limit(100)
  .build();

const result = await client.queryMapLayer(req);

// Bound — build and execute in one chain
const result = await MapLayerQueryBuilder.for(client, "myService", 0)
  .where("POP > 1000")
  .outFields("NAME", "POP")
  .limit(100)
  .run();

Index

Methods

build distinct extraParams geometry geometryType groupBy limit method objectIds offset orderBy outFields outStatistics returnCentroid returnGeometry run signal spatialRel where for from

Methods

build

build(): MapLayerQueryRequest
Build the MapLayerQueryRequest object without executing it.

Returns MapLayerQueryRequest
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:387

distinct

distinct(value?: boolean): this
Return only distinct values.
Parameters
- value: boolean = true
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:345

extraParams

extraParams(params: Record<string, string | number | boolean>): this
Set extra query parameters.
Parameters
- params: Record<string, string | number | boolean>
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:381

geometry

geometry(geom: string | Record<string, unknown>): this
Set a geometry filter. Accepts a geometry object or JSON string.
Parameters
- geom: string | Record<string, unknown>
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:297

geometryType

geometryType(type: EsriGeometryType): this
Set the geometry type for the geometry filter.
Parameters
- type: EsriGeometryType
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:303

groupBy

groupBy(fields: string): this
Set group-by fields for statistics queries.
Parameters
- fields: string
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:357

limit

limit(count: number): this
Set the maximum number of features to return.
Parameters
- count: number
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:327

method

method(m: QueryMethod): this
Set the HTTP method (GET or POST).
Parameters
- m: QueryMethod
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:369

objectIds

objectIds(ids: string | number[]): this
Filter by specific object IDs.
Parameters
- ids: string | number[]
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:339

offset

offset(count: number): this
Set the number of features to skip (for pagination).
Parameters
- count: number
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:333

orderBy

orderBy(fields: string): this
Set the fields to order results by (e.g. "NAME ASC").
Parameters
- fields: string
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:321

outFields

outFields(...fieldNames: string[]): this
Set the output fields to return. Accepts individual field names.
Parameters
- ...fieldNames: string[]
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:291

outStatistics

outStatistics(stats: string | readonly Record<string, unknown>[]): this
Set output statistics definitions.
Parameters
- stats: string | readonly Record<string, unknown>[]
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:363

returnCentroid

returnCentroid(value?: boolean): this
Return centroids instead of full geometries.
Parameters
- value: boolean = true
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:351

returnGeometry

returnGeometry(value: boolean): this
Whether to include geometry in the response.
Parameters
- value: boolean
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:315

run

run(): Promise<HonuaQueryResponse>
Build the request and execute it via the bound client. Throws if the builder was created with MapLayerQueryBuilder.from() (no client).

Returns Promise<HonuaQueryResponse>
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:418

signal

signal(s: AbortSignal): this
Attach an AbortSignal for cancellation.
Parameters
- s: AbortSignal
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:375

spatialRel

spatialRel(rel: EsriSpatialRel): this
Set the spatial relationship for the geometry filter.
Parameters
- rel: EsriSpatialRel
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:309

where

where(clause: string): this
Set the WHERE clause for filtering features.
Parameters
- clause: string
Returns this
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:285

`Static`for

for(
    client: HonuaClient,
    serviceId: string,
    layerId: number,
): MapLayerQueryBuilder
Create a builder bound to a client (enables .run() to execute the query).
Parameters
- client: HonuaClient
- serviceId: string
- layerId: number
Returns MapLayerQueryBuilder
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:280

`Static`from

from(serviceId: string, layerId: number): MapLayerQueryBuilder
Create a standalone builder (call .build() to get the request object).
Parameters
- serviceId: string
- layerId: number
Returns MapLayerQueryBuilder
- Defined in work/honua-sdk-js/honua-sdk-js/src/core/query-builder.ts:275

Class MapLayerQueryBuilder

Example

Index

Methods

Methods

build

Returns MapLayerQueryRequest

distinct

Parameters

Returns this

extraParams

Parameters

Returns this

geometry

Parameters

Returns this

geometryType

Parameters

Returns this

groupBy

Parameters

Returns this

limit

Parameters

Returns this

method

Parameters

Returns this

objectIds

Parameters

Returns this

offset

Parameters

Returns this

orderBy

Parameters

Returns this

outFields

Parameters

Returns this

outStatistics

Parameters

Returns this

returnCentroid

Parameters

Returns this

returnGeometry

Parameters

Returns this

run

Returns Promise<HonuaQueryResponse>

signal

Parameters

Returns this

spatialRel

Parameters

Returns this

where

Parameters

Returns this

Staticfor

Parameters

Returns MapLayerQueryBuilder

Staticfrom

Parameters

Returns MapLayerQueryBuilder

Settings

On This Page

`Static`for

`Static`from