Reference documentation and code samples for the Cloud Datastore V1 Client class FindNearest.
Nearest Neighbors search config. The ordering provided by FindNearest supersedes the order_by stage. If multiple documents have the same vector distance, the returned document order is not guaranteed to be stable between queries.
Generated from protobuf message google.datastore.v1.FindNearest
Namespace
Google \ Cloud \ Datastore \ V1Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ vector_property
PropertyReference
Required. An indexed vector property to search upon. Only documents which contain vectors whose dimensionality match the query_vector can be returned.
↳ query_vector
Value
Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions.
↳ distance_measure
int
Required. The Distance Measure to use, required.
↳ limit
Google\Protobuf\Int32Value
Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.
↳ distance_result_property
string
Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to entity property limitations.
↳ distance_threshold
Google\Protobuf\DoubleValue
Optional. Option to specify a threshold for which no less similar documents will be returned. The behavior of the specified distance_measure
will affect the meaning of the distance threshold. Since DOT_PRODUCT distances increase when the vectors are more similar, the comparison is inverted. For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold
getVectorProperty
Required. An indexed vector property to search upon. Only documents which contain vectors whose dimensionality match the query_vector can be returned.
hasVectorProperty
clearVectorProperty
setVectorProperty
Required. An indexed vector property to search upon. Only documents which contain vectors whose dimensionality match the query_vector can be returned.
$this
getQueryVector
Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions.
hasQueryVector
clearQueryVector
setQueryVector
Required. The query vector that we are searching on. Must be a vector of no more than 2048 dimensions.
$this
getDistanceMeasure
Required. The Distance Measure to use, required.
int
setDistanceMeasure
Required. The Distance Measure to use, required.
var
int
$this
getLimit
Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.
hasLimit
clearLimit
getLimitValue
Returns the unboxed value from getLimit()
Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.
int|null
setLimit
Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.
$this
setLimitValue
Sets the field by wrapping a primitive type in a Google\Protobuf\Int32Value object.
Required. The number of nearest neighbors to return. Must be a positive integer of no more than 100.
var
int|null
$this
getDistanceResultProperty
Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to entity property limitations.
string
setDistanceResultProperty
Optional. Optional name of the field to output the result of the vector distance calculation. Must conform to entity property limitations.
var
string
$this
getDistanceThreshold
Optional. Option to specify a threshold for which no less similar documents
will be returned. The behavior of the specified distance_measure
will
affect the meaning of the distance threshold. Since DOT_PRODUCT distances
increase when the vectors are more similar, the comparison is inverted.
For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold
hasDistanceThreshold
clearDistanceThreshold
getDistanceThresholdValue
Returns the unboxed value from getDistanceThreshold()
Optional. Option to specify a threshold for which no less similar documents
will be returned. The behavior of the specified distance_measure
will
affect the meaning of the distance threshold. Since DOT_PRODUCT distances
increase when the vectors are more similar, the comparison is inverted.
For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold
For DOT_PRODUCT: WHERE distance >= distance_threshold
float|null
setDistanceThreshold
Optional. Option to specify a threshold for which no less similar documents
will be returned. The behavior of the specified distance_measure
will
affect the meaning of the distance threshold. Since DOT_PRODUCT distances
increase when the vectors are more similar, the comparison is inverted.
For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold For DOT_PRODUCT: WHERE distance >= distance_threshold
$this
setDistanceThresholdValue
Sets the field by wrapping a primitive type in a Google\Protobuf\DoubleValue object.
Optional. Option to specify a threshold for which no less similar documents
will be returned. The behavior of the specified distance_measure
will
affect the meaning of the distance threshold. Since DOT_PRODUCT distances
increase when the vectors are more similar, the comparison is inverted.
For EUCLIDEAN, COSINE: WHERE distance <= distance_threshold
For DOT_PRODUCT: WHERE distance >= distance_threshold
var
float|null
$this