> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# filter_by_radius_geometry

### filter\_by\_radius\_geometry

<ul>
  <li>
    filter\_by\_radius\_geometry(\
    &#x20;table\_name: string,\
    &#x20;view\_name: string | undefined,\
    &#x20;column\_name: string,\
    &#x20;x\_center: number,\
    &#x20;y\_center: number,\
    &#x20;radius: number,\
    &#x20;options?: Record\<string, string>,\
    &#x20;callback?: [GPUdbCallback](https://docs.kinetica.com/content/api/nodejs/types/GPUdbCallback.md),\
    ): Promise\<[FilterByRadiusGeometryResponse](https://docs.kinetica.com/content/api/nodejs/interfaces/FilterByRadiusGeometryResponse.md)>

    Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI). The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a `view_name` is passed in as part of the request.

    #### Parameters

    <ul>
      <li>
        table\_name: string

        Name of the table on which the filter by radius operation will be performed, in \[schema\_name.]table\_name format, using standard name resolution rules. Must be an existing table.
      </li>

      <li>
        view\_name: string | undefined

        If provided, then this will be the name of the view containing the results, in \[schema\_name.]view\_name format, using standard name resolution rules and meeting table naming criteria. Must not be an already existing table or view.
      </li>

      <li>
        column\_name: string

        Name of the geospatial geometry column to be filtered.
      </li>

      <li>
        x\_center: number

        Value of the longitude of the center. Must be within \[-180.0, 180.0].
      </li>

      <li>
        y\_center: number

        Value of the latitude of the center. Must be within \[-90.0, 90.0].
      </li>

      <li>
        radius: number

        The radius of the circle within which the search will be performed. Must be a non-zero positive value. It is in meters; so, for example, a value of '42000' means 42 km.
      </li>

      <li>
        `Optional`options: Record\<string, string>

        Optional parameters.
      </li>

      <li>
        `Optional`callback: [GPUdbCallback](https://docs.kinetica.com/content/api/nodejs/types/GPUdbCallback.md)

        Optional callback function
      </li>
    </ul>

    #### Returns Promise\<[FilterByRadiusGeometryResponse](https://docs.kinetica.com/content/api/nodejs/interfaces/FilterByRadiusGeometryResponse.md)>

    Promise\<Types.FilterByRadiusGeometryResponse> - Promise resolving to the response

    <ul>
      <li>Defined in [src/GPUdb.ts:9762](https://github.com/kineticadb/kinetica-api-typescript/blob/master/src/GPUdb.ts#L9762)</li>
    </ul>
  </li>
</ul>

### filter\_by\_radius\_geometry\_request

<ul>
  <li>
    filter\_by\_radius\_geometry\_request(\
    &#x20;request: [FilterByRadiusGeometryRequest](https://docs.kinetica.com/content/api/nodejs/interfaces/FilterByRadiusGeometryRequest.md),\
    &#x20;callback?: [GPUdbCallback](https://docs.kinetica.com/content/api/nodejs/types/GPUdbCallback.md),\
    ): Promise\<[FilterByRadiusGeometryResponse](https://docs.kinetica.com/content/api/nodejs/interfaces/FilterByRadiusGeometryResponse.md)>

    Calculates which geospatial geometry objects from a table intersect a circle with the given radius and center point (i.e. circular NAI). The operation is synchronous, meaning that a response will not be returned until all the objects are fully available. The response payload provides the count of the resulting set. A new resultant set (view) which satisfies the input circular NAI restriction specification is also created if a `view_name` is passed in as part of the request.

    #### Parameters

    <ul>
      <li>
        request: [FilterByRadiusGeometryRequest](https://docs.kinetica.com/content/api/nodejs/interfaces/FilterByRadiusGeometryRequest.md)

        Request object containing the parameters for the operation
      </li>

      <li>
        `Optional`callback: [GPUdbCallback](https://docs.kinetica.com/content/api/nodejs/types/GPUdbCallback.md)

        Optional callback function
      </li>
    </ul>

    #### Returns Promise\<[FilterByRadiusGeometryResponse](https://docs.kinetica.com/content/api/nodejs/interfaces/FilterByRadiusGeometryResponse.md)>

    Promise\<Types.FilterByRadiusGeometryResponse> - Promise resolving to the response

    <ul>
      <li>Defined in [src/GPUdb.ts:9723](https://github.com/kineticadb/kinetica-api-typescript/blob/master/src/GPUdb.ts#L9723)</li>
    </ul>
  </li>
</ul>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.