Base class for calculating distances between two lat/long coordinates. More...

#include <geospatial.h>

Inheritance diagram for Xapian::LatLongMetric:

Public Member Functions
virtual	~LatLongMetric ()
	Destructor. More...

virtual double	pointwise_distance (const LatLongCoord &a, const LatLongCoord &b) const =0
	Return the distance between two coordinates, in metres. More...

double	operator() (const LatLongCoords &a, const LatLongCoords &b) const
	Return the distance between two coordinate lists, in metres. More...

double	operator() (const LatLongCoords &a, const std::string &b) const
	Return the distance between two coordinate lists, in metres. More...

double	operator() (const LatLongCoords &a, const char *b_ptr, size_t b_len) const
	Return the distance between two coordinate lists, in metres. More...

virtual LatLongMetric *	clone () const =0
	Clone the metric. More...

virtual std::string	name () const =0
	Return the full name of the metric. More...

virtual std::string	serialise () const =0
	Serialise object parameters into a string. More...

virtual LatLongMetric *	unserialise (const std::string &serialised) const =0
	Create object given string serialisation returned by serialise(). More...

Detailed Description

Base class for calculating distances between two lat/long coordinates.

Experimental - see https://xapian.org/docs/deprecation#experimental-features

Definition at line 303 of file geospatial.h.

Constructor & Destructor Documentation

◆ ~LatLongMetric()

LatLongMetric::~LatLongMetric ( )

virtual

Destructor.

Definition at line 38 of file latlong_metrics.cc.

Member Function Documentation

◆ clone()

virtual LatLongMetric* Xapian::LatLongMetric::clone ( ) const

pure virtual

Clone the metric.

Implemented in Xapian::GreatCircleMetric.

Referenced by Xapian::LatLongDistancePostingSource::clone().

◆ name()

virtual std::string Xapian::LatLongMetric::name ( ) const

pure virtual

Return the full name of the metric.

This is used when serialising and unserialising metrics; for example, for performing remote searches.

If the subclass is in a C++ namespace, the namespace should be included in the name, using "::" as a separator. For example, for a LatLongMetric subclass called "FooLatLongMetric" in the "Xapian" namespace the result of this call should be "Xapian::FooLatLongMetric".

Implemented in Xapian::GreatCircleMetric.

Referenced by Xapian::Registry::Internal::add_defaults(), Xapian::Registry::register_lat_long_metric(), and Xapian::LatLongDistancePostingSource::serialise().

◆ operator()() [1/3]

double LatLongMetric::operator()	(	const LatLongCoords &	a,
		const LatLongCoords &	b
	)		const

Return the distance between two coordinate lists, in metres.

The distance between the coordinate lists is defined to be the minimum pairwise distance between coordinates in the lists.

Exceptions

InvalidArgumentError either of the lists is empty.

Parameters

a	The first coordinate list.
b	The second coordinate list.

Definition at line 43 of file latlong_metrics.cc.

References Xapian::LatLongCoords::begin(), Xapian::LatLongCoords::empty(), and Xapian::LatLongCoords::end().

◆ operator()() [2/3]

double Xapian::LatLongMetric::operator()	(	const LatLongCoords &	a,
		const std::string &	b
	)		const

inline

Return the distance between two coordinate lists, in metres.

One of the coordinate lists is supplied in serialised form.

The distance between the coordinate lists is defined to be the minimum pairwise distance between coordinates in the lists.

Exceptions

InvalidArgumentError either of the lists is empty.

Parameters

a	The first coordinate list.
b	The second coordinate list, in serialised form.

Definition at line 337 of file geospatial.h.

References name, and Xapian::LatLongCoords::size().

◆ operator()() [3/3]

double LatLongMetric::operator()	(	const LatLongCoords &	a,
		const char *	b_ptr,
		size_t	b_len
	)		const

Return the distance between two coordinate lists, in metres.

One of the coordinate lists is supplied in serialised form.

The distance between the coordinate lists is defined to be the minimum pairwise distance between coordinates in the lists.

Exceptions

InvalidArgumentError either of the lists is empty.

Parameters

a	The first coordinate list.
b_ptr	The start of the serialised form of the second coordinate list.
b_len	The length of the serialised form of the second coordinate list.

Definition at line 72 of file latlong_metrics.cc.

References Xapian::LatLongCoords::begin(), Xapian::LatLongCoords::empty(), Xapian::LatLongCoords::end(), and Xapian::LatLongCoord::unserialise().