added an android route to redirect users to the app or to the store after 1.5 seconds

Author: rfontanarosa

firebase.json

@@ -37,6 +37,10 @@
         "source": "/vi{,/**}",
         "destination": "/vi/index.html"
       },
+      {
+        "source": "/android/**",
+        "destination": "/en/android.html"
+      },
       {
         "source": "/**",
         "destination": "/en/index.html"

web/src/app/pages/android/android.component.ts

@@ -0,0 +1,68 @@
+/**
+ * Copyright 2025 The Ground Authors.
+ *
+ * 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
+ *
+ *     https://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.
+ */
+
+import {Component, OnInit} from '@angular/core';
+import {Router} from '@angular/router';
+import {firstValueFrom} from 'rxjs';
+
+import {AppConfigService} from 'app/services/app-config/app-config.service';
+
+@Component({
+  selector: 'ground-android-page',
+  template: `
+    <div *ngIf="playStoreId$ | async as playStoreId">
+      <a
+        [href]="'https://play.google.com/store/apps/details?id=' + playStoreId"
+      >
+        Go to Play Store
+      </a>
+    </div>
+  `,
+})
+export class AndroidPageComponent implements OnInit {
+  fullPath = '';
+  playStoreId$ = this.appConfigService.getPlayStoreId();
+
+  constructor(
+    private appConfigService: AppConfigService,
+    private router: Router
+  ) {}
+
+  async ngOnInit(): Promise<void> {
+    this.fullPath = this.router.url;
+
+    const playStoreId = await firstValueFrom(this.playStoreId$);
+
+    if (!playStoreId) return;
+
+    const timeout = 1500; // ms
+
+    // Fallback: redirect to Play Store if app doesn't open
+    const fallback = setTimeout(() => {
+      window.location.href = `https://play.google.com/store/apps/details?id=${playStoreId}`;
+    }, timeout);
+
+    // Try opening the app via intent URL
+    window.location.href = `intent://${this.fullPath}#Intent;scheme=https;package=${playStoreId};end`;
+
+    // Cancel fallback if app is opened (browser loses focus)
+    const blurHandler = () => {
+      clearTimeout(fallback);
+      window.removeEventListener('blur', blurHandler);
+    };
+    window.addEventListener('blur', blurHandler);
+  }
+}

web/src/app/pages/android/android.module.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright 2025 The Ground Authors.
+ *
+ * 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
+ *
+ *     https://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.
+ */
+
+import {CommonModule} from '@angular/common';
+import {NgModule} from '@angular/core';
+import {RouterModule} from '@angular/router';
+
+import {AndroidPageComponent} from 'app/pages/android/android.component';
+
+@NgModule({
+  declarations: [AndroidPageComponent],
+  imports: [CommonModule, RouterModule],
+  exports: [AndroidPageComponent],
+})
+export class AndroidModule {}

web/src/app/routing.module.ts

@@ -30,6 +30,7 @@ import {NavigationService} from 'app/services/navigation/navigation.service';
 
 import {ShareSurveyComponent} from './components/share-survey/share-survey.component';
 import {AboutComponent} from './pages/about/about.component';
+import {AndroidPageComponent} from './pages/android/android.component';
 import {EditDetailsComponent} from './pages/edit-survey/edit-details/edit-details.component';
 import {EditJobComponent} from './pages/edit-survey/edit-job/edit-job.component';
 import {EditSurveyComponent} from './pages/edit-survey/edit-survey.component';
@@ -104,6 +105,11 @@ const routes: Routes = [
     path: NavigationService.ABOUT,
     component: AboutComponent,
   },
+  {
+    path: `${NavigationService.ANDROID_SEGMENT}`,
+    component: AndroidPageComponent,
+    children: [{path: '**', component: AndroidPageComponent}],
+  },
   {
     path: NavigationService.TERMS,
     component: TermsComponent,

web/src/app/services/navigation/url-params.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright 2025 The Ground Authors.
+ *
+ * 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
+ *
+ *     https://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.
+ */
+
+import {SideNavMode} from './navigation.service';
+
+export class UrlParams {
+  protected sideNavMode: SideNavMode | null;
+
+  constructor(
+    readonly surveyId: string | null,
+    readonly loiId: string | null,
+    readonly submissionId: string | null,
+    readonly taskId: string | null
+  ) {
+    if (this.loiId) {
+      this.sideNavMode = SideNavMode.JOB_LIST;
+    }
+    if (this.submissionId) {
+      this.sideNavMode = SideNavMode.SUBMISSION;
+    }
+    this.sideNavMode = null;
+  }
+}