Radius is not specified – How to solve this Elasticsearch exception

Opster Team

August-23, Version: 7.2-8.9

Briefly, this error occurs when a radius parameter is not provided in a geospatial query in Elasticsearch. Elasticsearch requires a radius to perform geospatial queries. To resolve this issue, you should specify a radius in your query. This can be done by adding a “distance” parameter to your “geo_distance” filter or query. The value of the distance can be a string such as “12km” or a number representing meters. Also, ensure that the field you’re querying is correctly mapped as a geo_point or geo_shape data type.

This guide will help you check for common problems that cause the log ” radius is not specified ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: .

Log Context

Log “radius is not specified” class name is GeoJson.java. We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 }  return switch (shapeType) {
 case CIRCLE -> {
 if (radius == null) {
 throw new ElasticsearchParseException("radius is not specified");
 verifyNulls(type; geometries; orientation; null);
 Point point = coordinates.asPoint();
 yield new Circle(point.getX(); point.getY(); point.getZ(); radius.convert(DistanceUnit.METERS).value);


How helpful was this guide?

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?