public class FilterByRadiusGeometryRequest extends Object implements org.apache.avro.generic.IndexedRecord
GPUdb.filterByRadiusGeometry
.
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 viewName
is passed in as part of the request.
Modifier and Type | Class and Description |
---|---|
static class |
FilterByRadiusGeometryRequest.Options
A set of string constants for the
FilterByRadiusGeometryRequest
parameter options . |
Constructor and Description |
---|
FilterByRadiusGeometryRequest()
Constructs a FilterByRadiusGeometryRequest object with default
parameters.
|
FilterByRadiusGeometryRequest(String tableName,
String viewName,
String columnName,
double xCenter,
double yCenter,
double radius,
Map<String,String> options)
Constructs a FilterByRadiusGeometryRequest object with the specified
parameters.
|
Modifier and Type | Method and Description | ||||
---|---|---|---|---|---|
boolean |
equals(Object obj) |
||||
Object |
get(int index)
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
static org.apache.avro.Schema |
getClassSchema()
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
String |
getColumnName()
Name of the geospatial geometry column to be filtered.
|
||||
Map<String,String> |
getOptions()
Optional parameters.
|
||||
double |
getRadius()
The radius of the circle within which the search will be performed.
|
||||
org.apache.avro.Schema |
getSchema()
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
String |
getTableName()
Name of the table on which the filter by radius operation will be
performed, in [schema_name.]table_name format, using standard
String getViewName()
If provided, then this will be the name of the view containing the
results, in [schema_name.]view_name format, using standard
double getXCenter()
Value of the longitude of the center.
| ||||
double |
getYCenter()
Value of the latitude of the center.
|
||||
int |
hashCode() |
||||
void |
put(int index,
Object value)
This method supports the Avro framework and is not intended to be called
directly by the user.
|
||||
FilterByRadiusGeometryRequest |
setColumnName(String columnName)
Name of the geospatial geometry column to be filtered.
|
||||
FilterByRadiusGeometryRequest |
setOptions(Map<String,String> options)
Optional parameters.
|
||||
FilterByRadiusGeometryRequest |
setRadius(double radius)
The radius of the circle within which the search will be performed.
|
||||
FilterByRadiusGeometryRequest |
setTableName(String tableName)
Name of the table on which the filter by radius operation will be
performed, in [schema_name.]table_name format, using standard
FilterByRadiusGeometryRequest setViewName(String viewName)
If provided, then this will be the name of the view containing the
results, in [schema_name.]view_name format, using standard
FilterByRadiusGeometryRequest setXCenter(double xCenter)
Value of the longitude of the center.
| ||||
FilterByRadiusGeometryRequest |
setYCenter(double yCenter)
Value of the latitude of the center.
|
||||
String |
toString() |
public FilterByRadiusGeometryRequest()
public FilterByRadiusGeometryRequest(String tableName, String viewName, String columnName, double xCenter, double yCenter, double radius, Map<String,String> options)
tableName
- 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.viewName
- 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. The default value is
''.columnName
- Name of the geospatial geometry column to be
filtered.xCenter
- Value of the longitude of the center. Must be within
[-180.0, 180.0]. The minimum allowed value is -180. The
maximum allowed value is 180.yCenter
- Value of the latitude of the center. Must be within
[-90.0, 90.0]. The minimum allowed value is -90. The
maximum allowed value is 90.radius
- 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.
The minimum allowed value is 0. The maximum allowed value
is MAX_INT.options
- Optional parameters.
CREATE_TEMP_TABLE
: If TRUE
, a unique temporary table name will be
generated in the sys_temp schema and used in
place of viewName
. This is always
allowed even if the caller does not have
permission to create tables. The generated name
is returned in QUALIFIED_VIEW_NAME
.
Supported values:
The default value is FALSE
.
COLLECTION_NAME
:
[DEPRECATED--please specify the containing
schema for the view as part of viewName
and use GPUdb.createSchema
to create the schema if
non-existent] Name of a schema for the newly
created view. If the schema provided is
non-existent, it will be automatically created.
Map
.public static org.apache.avro.Schema getClassSchema()
public String getTableName()
tableName
.public FilterByRadiusGeometryRequest setTableName(String tableName)
tableName
- The new value for tableName
.this
to mimic the builder pattern.public String getViewName()
viewName
.public FilterByRadiusGeometryRequest setViewName(String viewName)
viewName
- The new value for viewName
.this
to mimic the builder pattern.public String getColumnName()
columnName
.public FilterByRadiusGeometryRequest setColumnName(String columnName)
columnName
- The new value for columnName
.this
to mimic the builder pattern.public double getXCenter()
xCenter
.public FilterByRadiusGeometryRequest setXCenter(double xCenter)
xCenter
- The new value for xCenter
.this
to mimic the builder pattern.public double getYCenter()
yCenter
.public FilterByRadiusGeometryRequest setYCenter(double yCenter)
yCenter
- The new value for yCenter
.this
to mimic the builder pattern.public double getRadius()
radius
.public FilterByRadiusGeometryRequest setRadius(double radius)
radius
- The new value for radius
.this
to mimic the builder pattern.public Map<String,String> getOptions()
CREATE_TEMP_TABLE
: If TRUE
, a unique temporary table name will be
generated in the sys_temp schema and used in place of viewName
. This is always allowed even if the
caller does not have permission to create tables. The generated
name is returned in QUALIFIED_VIEW_NAME
.
Supported values:
The default value is FALSE
.
COLLECTION_NAME
:
[DEPRECATED--please specify the containing schema for the view
as part of viewName
and use GPUdb.createSchema
to create the schema if non-existent] Name
of a schema for the newly created view. If the schema provided
is non-existent, it will be automatically created.
Map
.options
.public FilterByRadiusGeometryRequest setOptions(Map<String,String> options)
CREATE_TEMP_TABLE
: If TRUE
, a unique temporary table name will be
generated in the sys_temp schema and used in place of viewName
. This is always allowed even if the
caller does not have permission to create tables. The generated
name is returned in QUALIFIED_VIEW_NAME
.
Supported values:
The default value is FALSE
.
COLLECTION_NAME
:
[DEPRECATED--please specify the containing schema for the view
as part of viewName
and use GPUdb.createSchema
to create the schema if non-existent] Name
of a schema for the newly created view. If the schema provided
is non-existent, it will be automatically created.
Map
.options
- The new value for options
.this
to mimic the builder pattern.public org.apache.avro.Schema getSchema()
getSchema
in interface org.apache.avro.generic.GenericContainer
public Object get(int index)
get
in interface org.apache.avro.generic.IndexedRecord
index
- the position of the field to getIndexOutOfBoundsException
public void put(int index, Object value)
put
in interface org.apache.avro.generic.IndexedRecord
index
- the position of the field to setvalue
- the value to setIndexOutOfBoundsException
Copyright © 2025. All rights reserved.