Package com.azure.search.documents.models

Class VectorizableImageUrlQuery

java.lang.Object
com.azure.search.documents.models.VectorQuery
com.azure.search.documents.models.VectorizableImageUrlQuery
All Implemented Interfaces:
com.azure.json.JsonSerializable<VectorQuery>
public final class VectorizableImageUrlQuery extends VectorQuery
The query parameters to use for vector search when an url that represents an image value that needs to be vectorized is provided.

  • Constructor Details

    • VectorizableImageUrlQuery

      public VectorizableImageUrlQuery()
      Creates an instance of VectorizableImageUrlQuery class.

  • Method Details

    • getKind

      public VectorQueryKind getKind()
      Get the kind property: The kind of vector query being performed.
      Overrides:
      getKind in class VectorQuery
      Returns:
      the kind value.

    • getUrl

      public String getUrl()
      Get the url property: The URL of an image to be vectorized to perform a vector search query.
      Returns:
      the url value.

    • setUrl

      public VectorizableImageUrlQuery setUrl(String url)
      Set the url property: The URL of an image to be vectorized to perform a vector search query.
      Parameters:
      url - the url value to set.
      Returns:
      the VectorizableImageUrlQuery object itself.

    • setKNearestNeighborsCount

      public VectorizableImageUrlQuery setKNearestNeighborsCount(Integer kNearestNeighborsCount)
      Set the kNearestNeighborsCount property: Number of nearest neighbors to return as top hits.
      Overrides:
      setKNearestNeighborsCount in class VectorQuery
      Parameters:
      kNearestNeighborsCount - the kNearestNeighborsCount value to set.
      Returns:
      the VectorQuery object itself.

    • setFields

      public VectorizableImageUrlQuery setFields(String... fields)
      Set the fields property: Vector Fields of type Collection(Edm.Single) to be included in the vector searched.
      Overrides:
      setFields in class VectorQuery
      Parameters:
      fields - the fields value to set.
      Returns:
      the VectorQuery object itself.

    • setExhaustive

      public VectorizableImageUrlQuery setExhaustive(Boolean exhaustive)
      Set the exhaustive property: When true, triggers an exhaustive k-nearest neighbor search across all vectors within the vector index. Useful for scenarios where exact matches are critical, such as determining ground truth values.
      Overrides:
      setExhaustive in class VectorQuery
      Parameters:
      exhaustive - the exhaustive value to set.
      Returns:
      the VectorQuery object itself.

    • setOversampling

      public VectorizableImageUrlQuery setOversampling(Double oversampling)
      Set the oversampling property: Oversampling factor. Minimum value is 1. It overrides the 'defaultOversampling' parameter configured in the index definition. It can be set only when 'rerankWithOriginalVectors' is true. This parameter is only permitted when a compression method is used on the underlying vector field.
      Overrides:
      setOversampling in class VectorQuery
      Parameters:
      oversampling - the oversampling value to set.
      Returns:
      the VectorQuery object itself.

    • setWeight

      public VectorizableImageUrlQuery setWeight(Float weight)
      Set the weight property: Relative weight of the vector query when compared to other vector query and/or the text query within the same search request. This value is used when combining the results of multiple ranking lists produced by the different vector queries and/or the results retrieved through the text query. The higher the weight, the higher the documents that matched that query will be in the final ranking. Default is 1.0 and the value needs to be a positive number larger than zero.
      Overrides:
      setWeight in class VectorQuery
      Parameters:
      weight - the weight value to set.
      Returns:
      the VectorQuery object itself.

    • setThreshold

      public VectorizableImageUrlQuery setThreshold(VectorThreshold threshold)
      Set the threshold property: The threshold used for vector queries. Note this can only be set if all 'fields' use the same similarity metric.
      Overrides:
      setThreshold in class VectorQuery
      Parameters:
      threshold - the threshold value to set.
      Returns:
      the VectorQuery object itself.

    • setFilterOverride

      public VectorizableImageUrlQuery setFilterOverride(String filterOverride)
      Set the filterOverride property: The OData filter expression to apply to this specific vector query. If no filter expression is defined at the vector level, the expression defined in the top level filter parameter is used instead.
      Overrides:
      setFilterOverride in class VectorQuery
      Parameters:
      filterOverride - the filterOverride value to set.
      Returns:
      the VectorQuery object itself.

    • toJson

      public com.azure.json.JsonWriter toJson(com.azure.json.JsonWriter jsonWriter) throws IOException
      Specified by:
      toJson in interface com.azure.json.JsonSerializable<VectorQuery>
      Overrides:
      toJson in class VectorQuery
      Throws:
      IOException

    • fromJson

      public static VectorizableImageUrlQuery fromJson(com.azure.json.JsonReader jsonReader) throws IOException
      Reads an instance of VectorizableImageUrlQuery from the JsonReader.
      Parameters:
      jsonReader - The JsonReader being read.
      Returns:
      An instance of VectorizableImageUrlQuery if the JsonReader was pointing to an instance of it, or null if it was pointing to JSON null.
      Throws:
      IOException - If an error occurs while reading the VectorizableImageUrlQuery.