Add CONTAINS relation to geo_shape query

At the time of geo_shape query conception, CONTAINS was not yet a supported spatial operation in Lucene. Since it is now available this commit adds ShapeRelation.CONTAINS to GeoShapeQuery. Randomized testing is included and documentation is updated.

Author: nknize

core/src/main/java/org/elasticsearch/common/geo/ShapeRelation.java

@@ -34,7 +34,8 @@ public enum ShapeRelation implements Writeable<ShapeRelation>{
 
     INTERSECTS("intersects"),
     DISJOINT("disjoint"),
-    WITHIN("within");
+    WITHIN("within"),
+    CONTAINS("contains");
 
     private final String relationName;
 

core/src/main/java/org/elasticsearch/index/query/GeoShapeQueryBuilder.java

@@ -361,6 +361,8 @@ public static SpatialArgs getArgs(ShapeBuilder shape, ShapeRelation relation) {
             return new SpatialArgs(SpatialOperation.Intersects, shape.build());
         case WITHIN:
             return new SpatialArgs(SpatialOperation.IsWithin, shape.build());
+        case CONTAINS:
+            return new SpatialArgs(SpatialOperation.Contains, shape.build());
         default:
             throw new IllegalArgumentException("invalid relation [" + relation + "]");
         }