location/java/android/location/GlonassAssistance.java

/*
 * Copyright (C) 2024 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.location;

import android.annotation.FlaggedApi;
import android.annotation.NonNull;
import android.annotation.Nullable;
import android.annotation.SystemApi;
import android.location.GnssAssistance.GnssSatelliteCorrections;
import android.location.flags.Flags;
import android.os.Parcel;
import android.os.Parcelable;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

/**
 * A class contains Glonass assistance.
 *
 * @hide
 */
@FlaggedApi(Flags.FLAG_GNSS_ASSISTANCE_INTERFACE)
@SystemApi
public final class GlonassAssistance implements Parcelable {

    /** The Glonass almanac. */
    @Nullable private final GlonassAlmanac mAlmanac;

    /** The UTC model. */
    @Nullable private final UtcModel mUtcModel;

    /** The list of auxiliary informations. */
    @NonNull private final List<AuxiliaryInformation> mAuxiliaryInformation;

    /** The list of time models. */
    @NonNull private final List<TimeModel> mTimeModels;

    /** The list of Glonass ephemeris. */
    @NonNull private final List<GlonassSatelliteEphemeris> mSatelliteEphemeris;

    /** The list of Glonass satellite corrections. */
    @NonNull private final List<GnssSatelliteCorrections> mSatelliteCorrections;

    /** The list of real time integrity models. */
    @NonNull private final List<RealTimeIntegrityModel> mRealTimeIntegrityModels;

    private GlonassAssistance(Builder builder) {
        mAlmanac = builder.mAlmanac;
        mUtcModel = builder.mUtcModel;
        if (builder.mAuxiliaryInformation != null) {
            mAuxiliaryInformation =
                    Collections.unmodifiableList(new ArrayList<>(builder.mAuxiliaryInformation));
        } else {
            mAuxiliaryInformation = new ArrayList<>();
        }
        if (builder.mTimeModels != null) {
            mTimeModels = Collections.unmodifiableList(new ArrayList<>(builder.mTimeModels));
        } else {
            mTimeModels = new ArrayList<>();
        }
        if (builder.mSatelliteEphemeris != null) {
            mSatelliteEphemeris =
                    Collections.unmodifiableList(new ArrayList<>(builder.mSatelliteEphemeris));
        } else {
            mSatelliteEphemeris = new ArrayList<>();
        }
        if (builder.mSatelliteCorrections != null) {
            mSatelliteCorrections =
                    Collections.unmodifiableList(new ArrayList<>(builder.mSatelliteCorrections));
        } else {
            mSatelliteCorrections = new ArrayList<>();
        }
        if (builder.mRealTimeIntegrityModels != null) {
            mRealTimeIntegrityModels =
                    Collections.unmodifiableList(new ArrayList<>(builder.mRealTimeIntegrityModels));
        } else {
            mRealTimeIntegrityModels = new ArrayList<>();
        }
    }

    /** Returns the Glonass almanac. */
    @Nullable
    public GlonassAlmanac getAlmanac() {
        return mAlmanac;
    }

    /** Returns the UTC model. */
    @Nullable
    public UtcModel getUtcModel() {
        return mUtcModel;
    }

    /** Returns the list of time models. */
    @NonNull
    public List<TimeModel> getTimeModels() {
        return mTimeModels;
    }

    /** Returns the list of Glonass satellite ephemeris. */
    @NonNull
    public List<GlonassSatelliteEphemeris> getSatelliteEphemeris() {
        return mSatelliteEphemeris;
    }

    /** Returns the list of Glonass satellite corrections. */
    @NonNull
    public List<GnssSatelliteCorrections> getSatelliteCorrections() {
        return mSatelliteCorrections;
    }

    /** Returns the list of real time integrity models. */
    @NonNull
    public List<RealTimeIntegrityModel> getRealTimeIntegrityModels() {
        return mRealTimeIntegrityModels;
    }

    /** Returns the list of auxiliary informations. */
    @NonNull
    public List<AuxiliaryInformation> getAuxiliaryInformation() {
        return mAuxiliaryInformation;
    }

    @Override
    public int describeContents() {
        return 0;
    }

    @Override
    public void writeToParcel(@NonNull Parcel dest, int flags) {
        dest.writeTypedObject(mAlmanac, flags);
        dest.writeTypedObject(mUtcModel, flags);
        dest.writeTypedList(mAuxiliaryInformation);
        dest.writeTypedList(mTimeModels);
        dest.writeTypedList(mSatelliteEphemeris);
        dest.writeTypedList(mSatelliteCorrections);
        dest.writeTypedList(mRealTimeIntegrityModels);
    }

    @Override
    @NonNull
    public String toString() {
        StringBuilder builder = new StringBuilder("GlonassAssistance[");
        builder.append("almanac = ").append(mAlmanac);
        builder.append(", utcModel = ").append(mUtcModel);
        builder.append(", auxiliaryInformation = ").append(mAuxiliaryInformation);
        builder.append(", timeModels = ").append(mTimeModels);
        builder.append(", satelliteEphemeris = ").append(mSatelliteEphemeris);
        builder.append(", satelliteCorrections = ").append(mSatelliteCorrections);
        builder.append(", realTimeIntegrityModels = ").append(mRealTimeIntegrityModels);
        builder.append("]");
        return builder.toString();
    }

    public static final @NonNull Creator<GlonassAssistance> CREATOR =
            new Creator<GlonassAssistance>() {
                @Override
                public GlonassAssistance createFromParcel(Parcel in) {
                    return new GlonassAssistance.Builder()
                            .setAlmanac(in.readTypedObject(GlonassAlmanac.CREATOR))
                            .setUtcModel(in.readTypedObject(UtcModel.CREATOR))
                            .setAuxiliaryInformation(
                                    in.createTypedArrayList(AuxiliaryInformation.CREATOR))
                            .setTimeModels(in.createTypedArrayList(TimeModel.CREATOR))
                            .setSatelliteEphemeris(
                                    in.createTypedArrayList(GlonassSatelliteEphemeris.CREATOR))
                            .setSatelliteCorrections(
                                    in.createTypedArrayList(GnssSatelliteCorrections.CREATOR))
                            .setRealTimeIntegrityModels(
                                    in.createTypedArrayList(RealTimeIntegrityModel.CREATOR))
                            .build();
                }

                @Override
                public GlonassAssistance[] newArray(int size) {
                    return new GlonassAssistance[size];
                }
            };

    /** Builder for {@link GlonassAssistance}. */
    public static final class Builder {
        private GlonassAlmanac mAlmanac;
        private UtcModel mUtcModel;
        private List<AuxiliaryInformation> mAuxiliaryInformation;
        private List<TimeModel> mTimeModels;
        private List<GlonassSatelliteEphemeris> mSatelliteEphemeris;
        private List<GnssSatelliteCorrections> mSatelliteCorrections;
        private List<RealTimeIntegrityModel> mRealTimeIntegrityModels;

        /** Sets the Glonass almanac. */
        @NonNull
        public Builder setAlmanac(@Nullable GlonassAlmanac almanac) {
            mAlmanac = almanac;
            return this;
        }

        /** Sets the UTC model. */
        @NonNull
        public Builder setUtcModel(@Nullable UtcModel utcModel) {
            mUtcModel = utcModel;
            return this;
        }

        /** Sets the list of auxiliary informations. */
        @NonNull
        public Builder setAuxiliaryInformation(
                @NonNull List<AuxiliaryInformation> auxiliaryInformation) {
            mAuxiliaryInformation = auxiliaryInformation;
            return this;
        }

        /** Sets the list of time models. */
        @NonNull
        public Builder setTimeModels(@NonNull List<TimeModel> timeModels) {
            mTimeModels = timeModels;
            return this;
        }

        /** Sets the list of Glonass satellite ephemeris. */
        @NonNull
        public Builder setSatelliteEphemeris(
                @NonNull List<GlonassSatelliteEphemeris> satelliteEphemeris) {
            mSatelliteEphemeris = satelliteEphemeris;
            return this;
        }

        /** Sets the list of Glonass satellite corrections. */
        @NonNull
        public Builder setSatelliteCorrections(
                @NonNull List<GnssSatelliteCorrections> satelliteCorrections) {
            mSatelliteCorrections = satelliteCorrections;
            return this;
        }

        /** Sets the list of real time integrity models. */
        @NonNull
        public Builder setRealTimeIntegrityModels(
                @NonNull List<RealTimeIntegrityModel> realTimeIntegrityModels) {
            mRealTimeIntegrityModels = realTimeIntegrityModels;
            return this;
        }

        /** Builds the {@link GlonassAssistance}. */
        @NonNull
        public GlonassAssistance build() {
            return new GlonassAssistance(this);
        }
    }
}