OpenSearch/docs/java-api/aggregations/metrics/avg-aggregation.asciidoc

[[java-aggs-metrics-avg]]
==== Avg Aggregation

Here is how you can use
{ref}/search-aggregations-metrics-avg-aggregation.html[Avg Aggregation]
with Java API.


===== Prepare aggregation request

Here is an example on how to create the aggregation request:

[source,java]
--------------------------------------------------
AvgAggregationBuilder aggregation =
        AggregationBuilders
                .avg("agg")
                .field("height");
--------------------------------------------------


===== Use aggregation response

Import Aggregation definition classes:

[source,java]
--------------------------------------------------
import org.elasticsearch.search.aggregations.metrics.avg.Avg;
--------------------------------------------------

[source,java]
--------------------------------------------------
// sr is here your SearchResponse object
Avg agg = sr.getAggregations().get("agg");
double value = agg.getValue();
--------------------------------------------------