1/*
2 * Copyright (C) 2019 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package android.hardware.gnss@2.0;
18
19/** The callback interface to report measurements from the HAL. */
20interface IGnssBatchingCallback {
21    /**
22     * Called when a batch of locations is output, by various means, including
23     * a flush request, as well as the buffer becoming full (if appropriate option
24     * is set.)
25     *
26     * All locations returned by this callback must be cleared from the hardware
27     * buffer, such the sequential calls of this callback do not return any
28     * redundant locations.  (Same lat/lon, at a new time, is acceptable.)
29     *
30     * The GnssLocation struct in gnss@2.0 is extended to include elapsed realtime
31     * information.
32     *
33     * @param locations GNSS Location information from HAL.
34     */
35    gnssLocationBatchCb(vec<GnssLocation> locations);
36};
37