---
# System prepended metadata

title: お得便スケジュール取得(/ride-advance/timetables) API
tags: [API仕様]

---

###### tags: `API仕様`

# お得便スケジュール取得(/ride-advance/timetables) API
出発地がエリアに含まれていれば
そのエリアから出発するお特便のスケジュールを返す

## URI（demo環境）
GET https://bff-wn5zp5rybq-an.a.run.app/ride-advance/timetables


## URI（熱海環境）
GET https://bff-z5ltmpxiqa-an.a.run.app/ride-advance/timetables


## パラメータの型
```typescript
{
  latitude: number; //出発地の緯度
  longitude: number;　//出発地の経度
  datetime: number;　//検索したい日付のunixtime
  appName: string; //連携アプリ名
}
```

## レスポンスボディ (JSON)
```typescript
{
  [id: string]: {
    originAreaId?: string;
    name: string;
    price?: number; //目的地がpointの時のみ
    productId: string;　//deprecated
    destination: ScheduledTransportLocation;
    externalProductCode: string;
    timeTable: {
      id: string;
      departureTime: { earlier: number; later: number };
      state: 'opened' | 'closed' | 'suspended' | 'arranging';
      numberOfPersons: number;
      groupOid: string;
    }[];
  };
};
```
metadata? : any;  を含めるようにする予定（未実装）

型
```typescript
type ScheduledTransportAreaLocation = {
  type: 'Area';
  name: string;
  areaId: string;
};

type ScheduledTransportPointLocation = {
  type: 'Point';
  name: string;
  location: {
    latitude: number;
    longitude: number;
  };
};

type ScheduledTransportMultiAreaLocation = {
  type: 'MultiArea';
  areas: {
    areaId: string;
    name: string;
  }[];
};

export type ScheduledTransportLocation =
  | ScheduledTransportAreaLocation
  | ScheduledTransportPointLocation
  | ScheduledTransportMultiAreaLocation;

```