blob: eae8d577c31f58d30fe60e5c4f43844cbbfc0685 [file] [log] [blame]
// Copyright 2018 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
namespace device {
namespace mojom {
class Geoposition;
} // namespace mojom
struct WifiData;
// Cache of recently resolved locations, keyed by the set of unique WiFi APs
// used in the network query.
class PositionCache {
virtual ~PositionCache() = default;
// Caches the current position response for the current set of cell ID and
// WiFi data. In the case of the cache exceeding an implementation-defined
// maximum size this will evict old entries in FIFO orderer of being added.
virtual void CachePosition(const WifiData& wifi_data,
const mojom::Geoposition& position) = 0;
// Searches for a cached position response for the current set of data.
// Returns nullptr if the position is not in the cache, or the cached
// position if available. Ownership remains with the cache. Do not store
// the pointer, treat it as an iterator into the cache's internals.
virtual const mojom::Geoposition* FindPosition(
const WifiData& wifi_data) const = 0;
// Returns most recently used position, or an invalid Geoposition if
// SetLastUsedNetworkPosition wasn't called yet.
virtual const mojom::Geoposition& GetLastUsedNetworkPosition() const = 0;
// Stores the most recently used position.
virtual void SetLastUsedNetworkPosition(
const mojom::Geoposition& position) = 0;
} // namespace device