Add Point property for mapping point datatype

Relates: #4718, elastic/elasticsearch#53804

This commit adds a Point property to map the new point data type.
A CartesianPoint type is introduced to model points.

src/Nest/Mapping/AttributeBased/ElasticsearchCorePropertyAttributeBase.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System;
+ using System;
 using System.Reflection;
 using System.Runtime.Serialization;
 

src/Nest/Mapping/DynamicTemplate/SingleMapping.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System;
+ using System;
 using System.Collections.Generic;
 using System.Linq.Expressions;
 
@@ -54,6 +54,10 @@ public IProperty GeoShape(Func<GeoShapePropertyDescriptor<T>, IGeoShapeProperty>
 		public IProperty Shape(Func<ShapePropertyDescriptor<T>, IShapeProperty> selector) =>
 			selector?.Invoke(new ShapePropertyDescriptor<T>());
 
+		/// <inheritdoc />
+		public IProperty Point(Func<PointPropertyDescriptor<T>, IPointProperty> selector) =>
+			selector?.Invoke(new PointPropertyDescriptor<T>());
+
 		/// <inheritdoc />
 		public IProperty IntegerRange(Func<IntegerRangePropertyDescriptor<T>, IIntegerRangeProperty> selector) =>
 			selector?.Invoke(new IntegerRangePropertyDescriptor<T>());

src/Nest/Mapping/Types/CorePropertyBase.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System.Diagnostics;
+ using System.Diagnostics;
 using System.Runtime.Serialization;
 using Elasticsearch.Net.Utf8Json;
 

src/Nest/Mapping/Types/DocValuesPropertyBase.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System.Runtime.Serialization;
+ using System.Runtime.Serialization;
 using Elasticsearch.Net.Utf8Json;
 
 namespace Nest

src/Nest/Mapping/Types/FieldType.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System.Runtime.Serialization;
+ using System.Runtime.Serialization;
 using Elasticsearch.Net;
 
 
@@ -148,6 +148,9 @@ public enum FieldType
 		Histogram,
 
 		[EnumMember(Value = "constant_keyword")]
-		ConstantKeyword
+		ConstantKeyword,
+
+		[EnumMember(Value = "point")]
+		Point,
 	}
 }

src/Nest/Mapping/Types/Properties.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System;
+ using System;
 using System.Collections.Generic;
 using System.Linq.Expressions;
 using Elasticsearch.Net.Utf8Json;
@@ -95,6 +95,9 @@ TReturnType Nested<TChild>(Func<NestedPropertyDescriptor<T, TChild>, INestedProp
 		/// <inheritdoc cref="IShapeProperty"/>
 		TReturnType Shape(Func<ShapePropertyDescriptor<T>, IShapeProperty> selector);
 
+		/// <inheritdoc cref="IPointProperty"/>
+		TReturnType Point(Func<PointPropertyDescriptor<T>, IPointProperty> selector);
+
 		/// <inheritdoc cref="ICompletionProperty"/>
 		TReturnType Completion(Func<CompletionPropertyDescriptor<T>, ICompletionProperty> selector);
 
@@ -153,42 +156,64 @@ public PropertiesDescriptor() : base(new Properties<T>()) { }
 
 		public PropertiesDescriptor(IProperties properties) : base(properties ?? new Properties<T>()) { }
 
+		/// <inheritdoc cref="IBinaryProperty"/>
 		public PropertiesDescriptor<T> Binary(Func<BinaryPropertyDescriptor<T>, IBinaryProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IBooleanProperty"/>
 		public PropertiesDescriptor<T> Boolean(Func<BooleanPropertyDescriptor<T>, IBooleanProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="ICompletionProperty"/>
 		public PropertiesDescriptor<T> Completion(Func<CompletionPropertyDescriptor<T>, ICompletionProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IDateProperty"/>
 		public PropertiesDescriptor<T> Date(Func<DatePropertyDescriptor<T>, IDateProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IDateNanosProperty"/>
 		public PropertiesDescriptor<T> DateNanos(Func<DateNanosPropertyDescriptor<T>, IDateNanosProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IDateRangeProperty"/>
 		public PropertiesDescriptor<T> DateRange(Func<DateRangePropertyDescriptor<T>, IDateRangeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IDoubleRangeProperty"/>
 		public PropertiesDescriptor<T> DoubleRange(Func<DoubleRangePropertyDescriptor<T>, IDoubleRangeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IFloatRangeProperty"/>
 		public PropertiesDescriptor<T> FloatRange(Func<FloatRangePropertyDescriptor<T>, IFloatRangeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IGeoPointProperty"/>
 		public PropertiesDescriptor<T> GeoPoint(Func<GeoPointPropertyDescriptor<T>, IGeoPointProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IGeoShapeProperty"/>
 		public PropertiesDescriptor<T> GeoShape(Func<GeoShapePropertyDescriptor<T>, IGeoShapeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IShapeProperty"/>
 		public PropertiesDescriptor<T> Shape(Func<ShapePropertyDescriptor<T>, IShapeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IPointProperty"/>
+		public PropertiesDescriptor<T> Point(Func<PointPropertyDescriptor<T>, IPointProperty> selector) => SetProperty(selector);
+
+		/// <inheritdoc cref="IIntegerRangeProperty"/>
 		public PropertiesDescriptor<T> IntegerRange(Func<IntegerRangePropertyDescriptor<T>, IIntegerRangeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IIpProperty"/>
 		public PropertiesDescriptor<T> Ip(Func<IpPropertyDescriptor<T>, IIpProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IIpRangeProperty"/>
 		public PropertiesDescriptor<T> IpRange(Func<IpRangePropertyDescriptor<T>, IIpRangeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IJoinProperty"/>
 		public PropertiesDescriptor<T> Join(Func<JoinPropertyDescriptor<T>, IJoinProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IKeywordProperty"/>
 		public PropertiesDescriptor<T> Keyword(Func<KeywordPropertyDescriptor<T>, IKeywordProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="ILongRangeProperty"/>
 		public PropertiesDescriptor<T> LongRange(Func<LongRangePropertyDescriptor<T>, ILongRangeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IMurmur3HashProperty"/>
 		public PropertiesDescriptor<T> Murmur3Hash(Func<Murmur3HashPropertyDescriptor<T>, IMurmur3HashProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="INestedProperty"/>
 		public PropertiesDescriptor<T> Nested<TChild>(Func<NestedPropertyDescriptor<T, TChild>, INestedProperty> selector)
 			where TChild : class => SetProperty(selector);
 
@@ -199,18 +224,23 @@ public PropertiesDescriptor<T> Nested<TChild>(Func<NestedPropertyDescriptor<T, T
 		/// </summary>
 		public PropertiesDescriptor<T> Number(Func<NumberPropertyDescriptor<T>, INumberProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IObjectProperty"/>
 		public PropertiesDescriptor<T> Object<TChild>(Func<ObjectTypeDescriptor<T, TChild>, IObjectProperty> selector)
 			where TChild : class => SetProperty(selector);
 
+		/// <inheritdoc cref="IPercolatorProperty"/>
 		public PropertiesDescriptor<T> Percolator(Func<PercolatorPropertyDescriptor<T>, IPercolatorProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="ITextProperty"/>
 		public PropertiesDescriptor<T> Text(Func<TextPropertyDescriptor<T>, ITextProperty> selector) => SetProperty(selector);
 
 		/// <inheritdoc cref="ISearchAsYouTypeProperty"/>
 		public PropertiesDescriptor<T> SearchAsYouType(Func<SearchAsYouTypePropertyDescriptor<T>, ISearchAsYouTypeProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="ITokenCountProperty"/>
 		public PropertiesDescriptor<T> TokenCount(Func<TokenCountPropertyDescriptor<T>, ITokenCountProperty> selector) => SetProperty(selector);
 
+		/// <inheritdoc cref="IFieldAliasProperty"/>
 		public PropertiesDescriptor<T> FieldAlias(Func<FieldAliasPropertyDescriptor<T>, IFieldAliasProperty> selector) => SetProperty(selector);
 
 		/// <inheritdoc cref="IRankFeatureProperty"/>
@@ -229,6 +259,9 @@ public PropertiesDescriptor<T> Object<TChild>(Func<ObjectTypeDescriptor<T, TChil
 		public PropertiesDescriptor<T> ConstantKeyword(Func<ConstantKeywordPropertyDescriptor<T>, IConstantKeywordProperty> selector) =>
 			SetProperty(selector);
 
+		/// <summary>
+		/// Map a custom property.
+		/// </summary>
 		public PropertiesDescriptor<T> Custom(IProperty customType) => SetProperty(customType);
 
 		private PropertiesDescriptor<T> SetProperty<TDescriptor, TInterface>(Func<TDescriptor, TInterface> selector)

src/Nest/Mapping/Types/PropertyBase.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System.Collections.Generic;
+ using System.Collections.Generic;
 using System.Diagnostics;
 using System.Reflection;
 using System.Runtime.Serialization;

src/Nest/Mapping/Types/PropertyFormatter.cs

@@ -81,6 +81,7 @@ public IProperty Deserialize(ref JsonReader reader, IJsonFormatterResolver forma
 				case FieldType.GeoPoint: return Deserialize<GeoPointProperty>(ref segmentReader, formatterResolver);
 				case FieldType.GeoShape: return Deserialize<GeoShapeProperty>(ref segmentReader, formatterResolver);
 				case FieldType.Shape: return Deserialize<ShapeProperty>(ref segmentReader, formatterResolver);
+				case FieldType.Point: return Deserialize<PointProperty>(ref segmentReader, formatterResolver);
 				case FieldType.Completion: return Deserialize<CompletionProperty>(ref segmentReader, formatterResolver);
 				case FieldType.TokenCount: return Deserialize<TokenCountProperty>(ref segmentReader, formatterResolver);
 				case FieldType.Murmur3Hash: return Deserialize<Murmur3HashProperty>(ref segmentReader, formatterResolver);
@@ -158,6 +159,9 @@ public void Serialize(ref JsonWriter writer, IProperty value, IJsonFormatterReso
 				case IShapeProperty shapeProperty:
 					Serialize(ref writer, shapeProperty, formatterResolver);
 					break;
+				case IPointProperty pointProperty:
+					Serialize(ref writer, pointProperty, formatterResolver);
+					break;
 				case ICompletionProperty completionProperty:
 					Serialize(ref writer, completionProperty, formatterResolver);
 					break;

src/Nest/Mapping/Types/Specialized/Point/PointAttribute.cs

@@ -0,0 +1,39 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+ namespace Nest
+{
+	/// <inheritdoc cref="IPointProperty" />
+	public class PointAttribute : ElasticsearchPropertyAttributeBase, IPointProperty
+	{
+		public PointAttribute() : base(FieldType.Point) { }
+
+		bool? IPointProperty.IgnoreMalformed { get; set; }
+		bool? IPointProperty.IgnoreZValue { get; set; }
+		CartesianPoint IPointProperty.NullValue { get; set; }
+
+		private IPointProperty Self => this;
+
+		/// <inheritdoc cref="IPointProperty.IgnoreMalformed" />
+		public bool IgnoreMalformed
+		{
+			get => Self.IgnoreMalformed.GetValueOrDefault(false);
+			set => Self.IgnoreMalformed = value;
+		}
+
+		/// <inheritdoc cref="IPointProperty.IgnoreZValue" />
+		public bool IgnoreZValue
+		{
+			get => Self.IgnoreZValue.GetValueOrDefault(true);
+			set => Self.IgnoreZValue = value;
+		}
+
+		/// <inheritdoc cref="IPointProperty.NullValue" />
+		public CartesianPoint NullValue
+		{
+			get => Self.NullValue;
+			set => Self.NullValue = value;
+		}
+	}
+}

src/Nest/Mapping/Types/Specialized/Point/PointProperty.cs

@@ -0,0 +1,87 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+using System.Diagnostics;
+using System.Runtime.Serialization;
+using Elasticsearch.Net.Utf8Json;
+
+namespace Nest
+{
+	/// <summary>
+	/// The point datatype facilitates the indexing of and searching
+	/// arbitrary `x, y` pairs that fall in a 2-dimensional planar
+	/// coordinate system.
+	/// <para />
+	/// You can query documents using this type using <see cref="IShapeQuery"/>.
+	/// <para />
+	/// Available in Elasticsearch 7.8.0+ with at least basic license level
+	/// </summary>
+	[InterfaceDataContract]
+	public interface IPointProperty : IProperty
+	{
+		/// <summary>
+		/// If <c>true</c>, malformed geojson shapes are ignored. If false (default),
+		/// malformed geojson shapes throw an exception and reject the whole document.
+		/// </summary>
+		[DataMember(Name ="ignore_malformed")]
+		bool? IgnoreMalformed { get; set; }
+
+		/// <summary>
+		/// If true (default) three dimension points will be accepted (stored in source) but
+		/// only x and y values will be indexed; the third dimension is ignored. If false,
+		/// geo-points containing any more than x and y (two dimensions) values throw
+		/// an exception and reject the whole document.
+		/// </summary>
+		[DataMember(Name ="ignore_z_value")]
+		bool? IgnoreZValue { get; set; }
+
+		/// <summary>
+		/// Accepts an point value which is substituted for any explicit `null` values.
+		/// Defaults to `null`, which means the field is treated as missing.
+		/// </summary>
+		[DataMember(Name = "null_value")]
+		CartesianPoint NullValue { get; set; }
+	}
+
+	/// <inheritdoc cref="IPointProperty" />
+	[DebuggerDisplay("{DebugDisplay}")]
+	public class PointProperty : PropertyBase, IPointProperty
+	{
+		public PointProperty() : base(FieldType.Point) { }
+
+		/// <inheritdoc />
+		public bool? IgnoreMalformed { get; set; }
+
+		/// <inheritdoc />
+		public bool? IgnoreZValue { get; set; }
+
+		/// <inheritdoc />
+		public CartesianPoint NullValue { get; set; }
+	}
+
+	/// <inheritdoc cref="IPointProperty" />
+	[DebuggerDisplay("{DebugDisplay}")]
+	public class PointPropertyDescriptor<T>
+		: PropertyDescriptorBase<PointPropertyDescriptor<T>, IPointProperty, T>, IPointProperty
+		where T : class
+	{
+		public PointPropertyDescriptor() : base(FieldType.Point) { }
+
+		bool? IPointProperty.IgnoreMalformed { get; set; }
+		bool? IPointProperty.IgnoreZValue { get; set; }
+		CartesianPoint IPointProperty.NullValue { get; set; }
+
+		/// <inheritdoc cref="IPointProperty.IgnoreMalformed" />
+		public PointPropertyDescriptor<T> IgnoreMalformed(bool? ignoreMalformed = true) =>
+			Assign(ignoreMalformed, (a, v) => a.IgnoreMalformed = v);
+
+		/// <inheritdoc cref="IPointProperty.IgnoreZValue" />
+		public PointPropertyDescriptor<T> IgnoreZValue(bool? ignoreZValue = true) =>
+			Assign(ignoreZValue, (a, v) => a.IgnoreZValue = v);
+
+		/// <inheritdoc cref="IPointProperty.NullValue" />
+		public PointPropertyDescriptor<T> NullValue(CartesianPoint nullValue) =>
+			Assign(nullValue, (a, v) => a.NullValue = v);
+	}
+}

src/Nest/Mapping/Visitor/IMappingVisitor.cs

@@ -34,6 +34,8 @@ public interface IMappingVisitor
 
 		void Visit(IShapeProperty property);
 
+		void Visit(IPointProperty property);
+
 		void Visit(INumberProperty property);
 
 		void Visit(ICompletionProperty property);
@@ -89,6 +91,8 @@ public virtual void Visit(IBooleanProperty property) { }
 
 		public virtual void Visit(IBinaryProperty property) { }
 
+		public virtual void Visit(IPointProperty property) { }
+
 		public virtual void Visit(INumberProperty property) { }
 
 		public virtual void Visit(IObjectProperty property) { }

src/Nest/Mapping/Visitor/IPropertyVisitor.cs

@@ -32,6 +32,8 @@ public interface IPropertyVisitor
 
 		void Visit(IShapeProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute);
 
+		void Visit(IPointProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute);
+
 		void Visit(ICompletionProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute);
 
 		void Visit(IIpProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute);

src/Nest/Mapping/Visitor/MappingWalker.cs

@@ -165,6 +165,12 @@ public void Accept(IProperties properties)
 							Accept(t.Fields);
 						});
 						break;
+					case FieldType.Point:
+						Visit<IPointProperty>(field, t =>
+						{
+							_visitor.Visit(t);
+						});
+						break;
 					case FieldType.Completion:
 						Visit<ICompletionProperty>(field, t =>
 						{

src/Nest/Mapping/Visitor/NoopPropertyVisitor.cs

@@ -20,6 +20,8 @@ public virtual void Visit(IGeoShapeProperty type, PropertyInfo propertyInfo, Ela
 
 		public virtual void Visit(IShapeProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute) { }
 
+		public virtual void Visit(IPointProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute) { }
+
 		public virtual void Visit(ICompletionProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute) { }
 
 		public virtual void Visit(IMurmur3HashProperty type, PropertyInfo propertyInfo, ElasticsearchPropertyAttributeBase attribute) { }

src/Nest/QueryDsl/Geo/GeoLocation.cs

@@ -2,7 +2,7 @@
 // Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
 // See the LICENSE file in the project root for more information
 
-using System;
+ using System;
 using System.Globalization;
 using System.Runtime.Serialization;
 using Elasticsearch.Net.Utf8Json;