一、引言

二、技术背景

1. 鸿蒙航班/高铁动态管理架构

• ​​实时动态查询​​：通过对接航空公司/铁路局的开放API（如飞常准API、12306开放平台），实时获取航班/高铁的当前状态（如起飞时间、到达时间、延误状态、登机口/检票口信息）；
• ​​智能值机提醒​​：根据航班/高铁的起飞/发车时间，自动计算值机截止时间（如航班起飞前2小时开放值机），在临近截止时推送提醒（如“距离值机截止还有30分钟”），并支持一键跳转至值机页面完成电子登机牌/车票领取；
• ​​延误主动通知​​：当航班/高铁出现延误、取消或登机口/检票口变更时，系统通过鸿蒙 ​​推送服务（Push Kit）​​ 主动向用户发送通知（如“您的航班CA123延误1小时，新起飞时间14:30，登机口变更为A12”），并关联后续行程（如高铁发车时间）提供调整建议；
• ​​导航引导​​：通过鸿蒙 ​​定位服务（Location Kit）​​ 和 ​​地图服务（Map Kit）​​，实时定位用户当前位置（如机场航站楼/高铁站候车厅），规划至登机口/检票口的最优路线（步行导航），并提供实时距离提示（如“登机口A12距离您200米，预计步行3分钟”）；
• ​​多设备协同​​：支持手机端与车机端（如鸿蒙智能手表、平板）的互联，车机屏幕实时显示航班/高铁动态，智能手表接收振动提醒（如延误通知），实现跨设备无缝同步；
• ​​行程关联与推荐​​：自动关联用户的航班与高铁行程（如“航班落地后需换乘高铁G1234”），当航班延误时，推送“高铁发车时间剩余1小时，建议改签”的智能建议。

2. 核心技术点

• ​​交通数据API集成​​：对接第三方交通数据服务商（如飞常准、航旅纵横、12306开放平台），通过HTTP/HTTPS协议获取实时航班/高铁状态（如JSON格式数据），包含航班号、起降时间、延误状态、登机口/检票口等关键信息；
• ​​分布式数据同步​​：用户的行程信息（如航班号、高铁车次）通过鸿蒙 ​​分布式数据库（@ohos.data.preferences）​​ 或云端同步，确保手机、车机、手表等多终端数据一致；
• ​​推送服务（Push Kit）​​：利用鸿蒙推送服务实现延误/值机提醒的主动推送（支持富媒体通知，如包含登机口变更详情的卡片），用户点击通知可直接跳转至值机或导航页面；
• ​​定位与导航集成​​：通过鸿蒙 ​​定位服务（Location Kit）​​ 获取用户当前位置（如机场内的Wi-Fi/蓝牙定位），结合 ​​地图服务（Map Kit）​​ 规划至登机口/检票口的步行路线，提供实时导航指引；
• ​​智能规则引擎​​：基于规则（如“延误超过30分钟且后续高铁发车时间<1小时”）与机器学习模型（分析用户历史行程延误影响），自动生成个性化建议（如“建议改签高铁”）。

三、应用使用场景

1. 个人旅客出行（单程航班/高铁）

• ​​场景描述​​：旅客计划乘坐航班CA123从北京飞往上海（起飞时间10:00），通过手机APP设置“值机提醒”（起飞前2小时开放值机），系统在8:00推送“距离值机截止还有2小时”；起飞前1小时，航班因天气延误30分钟（新起飞时间10:30），系统主动通知“您的航班CA123延误30分钟，新起飞时间10:30，登机口变更为A12”，并导航至A12登机口；
• ​​需求​​：实时动态查询（起飞/延误状态）、智能值机提醒（值机截止时间）、延误主动通知（含新登机口）、导航至登机口。

2. 商务联运行程（航班+高铁）

• ​​场景描述​​：商务人士上午乘坐航班CZ3001从广州飞往深圳（降落时间12:00），随后需换乘高铁G1234从深圳北站前往香港（发车时间13:30）。系统关联两段行程，当航班延误20分钟（降落时间12:20）时，推送“您的航班延误20分钟，高铁发车时间剩余1小时10分钟，建议提前前往深圳北站检票口（D5）”；用户点击通知后，导航至深圳北站检票口D5；
• ​​需求​​：多行程关联（航班与高铁）、动态影响分析（延误对后续行程的影响）、智能建议（是否改签）、导航至高铁检票口。

3. 机场/高铁站内导航（旅客定位）

• ​​场景描述​​：旅客到达机场后，通过手机APP查看“当前航班CA123的登机口为A12，距离您当前位置（T3航站楼出发层）约500米，步行预计7分钟”，系统提供实时导航（避开拥挤通道）；若旅客在候机厅内移动，系统通过室内定位（如蓝牙信标）更新距离（如“登机口A12距离您现在位置300米，剩余4分钟”）；
• ​​需求​​：室内定位（机场/高铁站内）、实时距离提示、动态导航更新。

4. 特殊场景（延误/取消应对）

• ​​场景描述​​：航班因机械故障取消（如航班MU5678），系统立即推送“您的航班MU5678已取消，建议改签至下一班航班MU5680（起飞时间16:00）”；若用户选择改签，系统自动跳转至航空公司APP的值机页面；若用户放弃行程，推送“可申请退票，退票链接XXX”；
• ​​需求​​：实时异常通知（取消/延误）、改签/退票引导、自动化操作支持。

四、不同场景下详细代码实现

场景 1：手机APP实时查询航班动态（基础版）

1.1 项目结构

FlightApp/
├── entry/src/main/ets/pages/
│   ├── Index.ets          // 主页面（查询航班动态）
│   ├── FlightManager.ets  // 航班数据查询逻辑（API对接）
│   └── NotificationManager.ets // 通知提醒逻辑（推送/本地通知）
├── entry/src/main/module.json5  // 模块配置（声明网络与推送权限）
└── build-profile.json5

1.2 权限配置（module.json5）

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone" // 手机端查询
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET", // 网络权限（调用交通API）
        "reason": "$string:internet_permission_reason"
      },
      {
        "name": "ohos.permission.PUSH", // 推送权限（接收延误通知）
        "reason": "$string:push_permission_reason"
      }
    ],
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home"
            ]
          }
        ]
      }
    ]
  }
}

1.3 航班数据查询逻辑（FlightManager.ets）

// entry/src/main/ets/pages/FlightManager.ets
import http from '@ohos.net.http'; // 鸿蒙HTTP网络请求模块

// 航班状态接口
export interface FlightStatus {
  flightNumber: string; // 航班号（如CA123）
  scheduledDeparture: string; // 计划起飞时间（如"10:00"）
  actualDeparture: string; // 实际起飞时间（如"10:30"）
  status: string; // 状态（如"延误"、"准时"、"取消"）
  gate: string; // 登机口（如"A12"）
  terminal: string; // 航站楼（如"T3"）
}

export class FlightManager {
  private readonly API_BASE_URL = 'https://api.flightstatus.example.com/v1'; // 模拟交通API地址

  // 查询指定航班的实时状态
  async queryFlightStatus(flightNumber: string): Promise<FlightStatus | null> {
    try {
      // 模拟HTTP请求获取航班数据（实际调用真实API）
      const response = await this.mockApiRequest(flightNumber);
      return response;
    } catch (error) {
      console.error('查询航班动态失败:', error);
      return null;
    }
  }

  // 模拟API请求（实际替换为http.request）
  private async mockApiRequest(flightNumber: string): Promise<FlightStatus> {
    // 模拟返回航班CA123的实时数据（延误30分钟，登机口A12）
    if (flightNumber === 'CA123') {
      return {
        flightNumber: 'CA123',
        scheduledDeparture: '10:00',
        actualDeparture: '10:30',
        status: '延误',
        gate: 'A12',
        terminal: 'T3'
      };
    }
    // 模拟返回航班CZ3001的准时数据
    if (flightNumber === 'CZ3001') {
      return {
        flightNumber: 'CZ3001',
        scheduledDeparture: '12:00',
        actualDeparture: '12:00',
        status: '准时',
        gate: 'B08',
        terminal: 'T2'
      };
    }
    throw new Error('未找到指定航班');
  }
}

1.4 主页面（Index.ets）

// entry/src/main/ets/pages/Index.ets
import { FlightManager } from './FlightManager.ets';

@Entry
@Component
struct Index {
  @State private flightManager: FlightManager = new FlightManager();
  @State private flightNumber: string = 'CA123'; // 默认查询的航班号
  @State private flightStatus: any = null; // 航班动态信息

  aboutToAppear() {
    // 初始化时查询默认航班
    this.queryFlightStatus();
  }

  // 查询航班动态
  private async queryFlightStatus() {
    const status = await this.flightManager.queryFlightStatus(this.flightNumber);
    this.flightStatus = status;
  }

  build() {
    Column() {
      Text('航班动态查询')
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .margin({ bottom: 30 });

      // 航班号输入（简化：默认CA123）
      Text(`当前查询：航班 ${this.flightNumber}`)
        .fontSize(16)
        .margin({ bottom: 20 });

      if (!this.flightStatus) {
        Text('🔍 正在查询航班动态...')
          .fontSize(16)
          .fontColor('#666');
      } else {
        // 航班动态详情
        Column() {
          Text(`✈️ 航班号: ${this.flightStatus.flightNumber}`)
            .fontSize(18)
            .fontWeight(FontWeight.Medium)
            .margin({ bottom: 10 });
          Text(`🕐 计划起飞: ${this.flightStatus.scheduledDeparture}`)
            .fontSize(16)
            .margin({ bottom: 5 });
          Text(`🕐 实际起飞: ${this.flightStatus.actualDeparture}`)
            .fontSize(16)
            .margin({ bottom: 5 });
          Text(`📊 状态: ${this.flightStatus.status}`)
            .fontSize(16)
            .fontColor(this.flightStatus.status === '延误' ? '#f44336' : this.flightStatus.status === '准时' ? '#4caf50' : '#ff9800')
            .margin({ bottom: 10 });
          Text(`🚪 登机口: ${this.flightStatus.gate} (航站楼: ${this.flightStatus.terminal})`)
            .fontSize(16)
            .margin({ bottom: 20 });
        }
        .width('100%')
        .padding(15)
        .border({ width: 1, color: '#ddd', radius: 8 });
      }

      // 刷新按钮
      Button('刷新动态')
        .onClick(() => {
          this.queryFlightStatus();
        })
        .margin({ top: 20 });
    }
    .width('100%')
    .height('100%')
    .padding(20)
    .justifyContent(FlexAlign.Start);
  }
}

• 用户打开手机APP后，输入航班号（如CA123），点击“刷新动态”按钮，系统调用交通API获取实时数据；
• 页面显示航班的详细状态（如“计划起飞10:00，实际起飞10:30，延误30分钟，登机口A12”），状态为“延误”时文字显示为红色；
• 用户可随时点击“刷新动态”更新最新信息。

场景 2：车机端智能延误通知与导航（进阶版）

2.1 车机端延误通知逻辑（扩展 FlightManager.ets）

// 在 FlightManager.ets 中添加车机端延误通知方法
import navigation from '@ohos.navigation'; // 鸿蒙导航组件
import location from '@ohos.location'; // 鸿蒙定位组件

export class FlightManager {
  // ... 原有代码 ...

  // 检查延误并触发通知与导航（模拟接收API推送的延误数据）
  async checkDelayAndNotify(flightNumber: string, newStatus: string, newDeparture: string, newGate: string, currentLocation: { latitude: number; longitude: number }) {
    // 模拟获取当前登机口位置（实际通过机场地图API查询）
    const gateLocation = this.getGateLocation(newGate); // { latitude: 30.5729, longitude: 104.0669 }

    // 计算用户与登机口的距离（简化：Haversine公式）
    const distance = this.calculateDistance(
      currentLocation.latitude, currentLocation.longitude,
      gateLocation.latitude, gateLocation.longitude
    );

    // 触发延误通知（模拟鸿蒙推送）
    this.sendDelayNotification(flightNumber, newStatus, newDeparture, newGate, distance);

    // 规划导航至登机口
    await this.navigate-toGate(currentLocation, gateLocation);
  }

  // 模拟获取登机口位置（实际通过机场API）
  private getGateLocation(gate: string): { latitude: number; longitude: number } {
    // 示例：登机口A15的坐标（假设）
    if (gate === 'A15') {
      return { latitude: 30.5729, longitude: 104.0669 };
    }
    return { latitude: 30.5728, longitude: 104.0668 }; // 默认位置
  }

  // 计算两点间距离（Haversine公式简化版，单位：米）
  private calculateDistance(lat1: number, lon1: number, lat2: number, lon2: number): number {
    const R = 6371e3; // 地球半径（米）
    const φ1 = lat1 * Math.PI / 180;
    const φ2 = lat2 * Math.PI / 180;
    const Δφ = (lat2 - lat1) * Math.PI / 180;
    const Δλ = (lon2 - lon1) * Math.PI / 180;

    const a = Math.sin(Δφ/2) * Math.sin(Δφ/2) +
              Math.cos(φ1) * Math.cos(φ2) *
              Math.sin(Δλ/2) * Math.sin(Δλ/2);
    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a));

    return R * c; // 返回距离（米）
  }

  // 发送延误通知（模拟鸿蒙推送服务）
  private sendDelayNotification(flightNumber: string, status: string, departure: string, gate: string, distance: number) {
    const message = `您的航班${flightNumber} ${status}，新起飞时间${departure}，登机口变更为${gate}，距离您约${Math.round(distance)}米`;
    console.log(`🔔 推送通知：${message}`);
    // 实际调用鸿蒙Push Kit发送通知（包含按钮“查看导航”）
  }

  // 导航至登机口（调用鸿蒙导航API）
  private async navigate-toGate(current: { latitude: number; longitude: number }, gate: { latitude: number; longitude: number }) {
    try {
      await navigation.planRoute({
        type: navigation.RouteType.WALKING, // 步行模式（机场内）
        startLocation: current,
        endLocation: gate,
        options: {
          avoidObstacles: true // 避免障碍物（如立柱）
        }
      });
      console.log('🗺️ 导航至登机口已规划');
    } catch (error) {
      console.error('导航失败:', error);
    }
  }
}

2.2 车机端主页面（CarSide.ets）

// entry/src/main/ets/pages/CarSide.ets
import { FlightManager } from './FlightManager.ets';

@Entry
@Component
struct CarSide {
  @State private flightManager: FlightManager = new FlightManager();
  @State private currentLocation: { latitude: number; longitude: number } = { latitude: 30.5728, longitude: 104.0668 }; // 示例：用户当前位置（机场内）
  @State private flightNumber: string = 'CA123'; // 示例航班号

  aboutToAppear() {
    // 模拟接收到航班延误推送（实际通过API监听）
    this.handleDelayNotification();
  }

  // 处理延误通知（模拟API推送的延误数据）
  private async handleDelayNotification() {
    // 模拟数据：航班CA123延误，新起飞时间11:30，登机口变更为A15
    await this.flightManager.checkDelayAndNotify(
      this.flightNumber,
      '延误',
      '11:30',
      'A15',
      this.currentLocation
    );
  }

  build() {
    Column() {
      Text('车机端 - 航班动态管理')
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .margin({ bottom: 30 });

      Text(`🚗 当前位置：机场内（模拟坐标 ${this.currentLocation.latitude}, ${this.currentLocation.longitude}）`)
        .fontSize(16)
        .margin({ bottom: 20 });

      Text(`📢 监听航班 ${this.flightNumber} 的延误通知...`)
        .fontSize(16)
        .margin({ bottom: 20 });

      // 模拟通知结果（实际通过Push Kit回调）
      Text('🔔 （模拟）已推送：航班CA123延误，登机口变更为A15，距离您约200米，请前往登机口')
        .fontSize(16)
        .fontColor('#f44336')
        .fontWeight(FontWeight.Bold)
        .margin({ bottom: 20 });
    }
    .width('100%')
    .height('100%')
    .padding(20)
    .justifyContent(FlexAlign.Center);
  }
}

• 车机系统接收模拟的航班延误推送（如“航班CA123延误，新起飞时间11:30，登机口变更为A15”）；
• 系统自动计算用户当前位置与登机口A15的距离（如200米），并通过鸿蒙推送通知用户；
• 用户点击通知后（或自动触发），车机导航规划步行路线至登机口A15，并显示“预计步行3分钟”。

五、原理解释

1. 鸿蒙航班/高铁动态管理的核心流程

1. ​​数据采集​​：通过对接航空公司/铁路局的开放API（如飞常准API、12306开放平台），实时获取航班/高铁的动态信息（如起飞时间、延误状态、登机口/检票口），数据以JSON格式返回（包含航班号、计划/实际时间、状态、位置等字段）；
2. ​​动态查询​​：用户通过手机APP或车机系统输入航班号/车次，系统调用API查询实时状态，并在页面展示（如“计划起飞10:00，实际起飞10:30，延误30分钟”）；
3. ​​智能提醒​​：根据航班/高铁的规则（如值机截止时间=起飞前2小时、延误通知阈值=延误超过20分钟），系统通过鸿蒙 ​​推送服务（Push Kit）​​ 或本地通知，在临近关键节点时提醒用户（如“距离值机截止还有30分钟”“您的航班延误1小时”）；
4. ​​导航引导​​：当用户需要前往登机口/检票口时，系统通过鸿蒙 ​​定位服务（Location Kit）​​ 获取用户当前位置（如机场内的Wi-Fi定位），结合 ​​地图服务（Map Kit）​​ 规划步行/驾车路线（如“登机口A12距离您200米，步行3分钟”），并提供实时导航指引；
5. ​​多设备协同​​：手机端接收推送并展示详情，车机端同步显示动态（如航班状态），智能手表接收振动提醒（如延误通知），实现跨设备无缝同步；
6. ​​行程关联​​：系统自动关联用户的航班与高铁行程（如通过用户手动输入或历史记录），当航班延误时，推送“后续高铁发车时间剩余1小时，建议调整”的智能建议。

2. 关键技术点

• ​​交通数据API集成​​：通过HTTP/HTTPS协议对接第三方交通数据服务商（如飞常准、航旅纵横、12306），获取实时航班/高铁状态，需处理API的认证（如API Key）、数据格式（如JSON解析）和错误重试机制；
• ​​分布式数据同步​​：用户的行程信息（如航班号、高铁车次）通过鸿蒙 ​​分布式数据库（@ohos.data.preferences）​​ 或云端同步，确保手机、车机、手表等多终端数据一致，避免重复查询；
• ​​推送服务（Push Kit）​​：利用鸿蒙推送服务实现延误/值机提醒的主动推送，支持富媒体通知（如包含登机口变更详情的卡片），用户点击通知可直接跳转至值机或导航页面；
• ​​定位与导航集成​​：通过鸿蒙 ​​定位服务（Location Kit）​​ 获取用户当前位置（如机场内的蓝牙信标定位），结合 ​​地图服务（Map Kit）​​ 规划至登机口/检票口的步行路线，提供实时距离提示（如“距离您200米”）；
• ​​智能规则引擎​​：基于规则（如“延误超过30分钟且后续高铁发车时间<1小时”）与机器学习模型（分析用户历史行程延误影响），自动生成个性化建议（如“建议改签高铁”）。

六、核心特性