com.couchbase.client.scala.search.queries.GeoDistanceQuery.scala Maven / Gradle / Ivy

Go to download
/*
 * Copyright (c) 2019 Couchbase, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.couchbase.client.scala.search.queries

import com.couchbase.client.core.api.search.queries.CoreGeoDistanceQuery

/** An FTS query that finds all matches from a given location (point) within the given distance.
  *
  * @param locationLon the location's longitude
  * @param locationLat the location's latitude
  * @param distance    the distance to search from the location, e.g. "10mi"
  *
  * @since 1.0.0
  */
case class GeoDistanceQuery(
    private[scala] val locationLon: Double,
    private[scala] val locationLat: Double,
    private[scala] val distance: String,
    private[scala] val field: Option[String] = None,
    private[scala] val boost: Option[Double] = None
) extends SearchQuery {

  /** If specified, only this field will be matched.
    *
    * @return a copy of this, for chaining
    */
  def field(field: String): GeoDistanceQuery = {
    copy(field = Some(field))
  }

  /** The boost parameter is used to increase the relative weight of a clause (with a boost greater than 1) or decrease
    * the relative weight (with a boost between 0 and 1)
    *
    * @param boost the boost parameter, which must be >= 0
    *
    * @return a copy of this, for chaining
    */
  def boost(boost: Double): GeoDistanceQuery = {
    copy(boost = Some(boost))
  }

  override private[scala] def toCore =
    new CoreGeoDistanceQuery(
      locationLon,
      locationLat,
      distance,
      field.orNull,
      boost.map(_.asInstanceOf[java.lang.Double]).orNull
    )
}