TownPass

English

繁體中文

English

繁體中文

Appearance

userinfo

Web Call Example ​

json
{
  "name": "userinfo",
  "data": null
}

App return ​

Account

  • id: User Unique ID
    string

  • account: User Account
    string

  • username: Username
    string

  • realName: Real Name
    string

  • idNo: ID Number
    string

  • email: Email
    string

  • phoneNo: Mobile Number
    string

  • birthday: Birthday
    string

  • memberType: Membership Type
    string

    "personal": Regular Member

    "organization": Organizational Member
"foreigner": Foreign National
"employee": Taipei City Government Employee

  • verifyLevel: Member Verification Level
    string

    0: Unverified
    > Greater Than 0: Real Name Verified

  • addresses: Mailing Address
    array[Address]

    Address:

    • zip3: Postal Code
      int

    • city: Township/City
      string

    • town: Urban Area
      string

    • village: Neighborhood
      string

    • street: Street
      string

    • usageType: Label Type
      string

      0: Other
      > 1: Home
      > 2: Company

    • seq: Serial Number
      int

    • priority: Is Default Address
      bool

  • residentAddress: Registered Address
    string

  • citizen: Is Taipei Citizen
    bool

  • nativePeople: Is Indigenous
    bool

  • cityInternetUid: Old Online Citizen ID
    string

App return example ​

json
{
  "name": "userinfo",
  "data": {
    "id": "7f3562f4-bb3f-4ec7-89b9-da3b4b5ff250",
    "account": "wz7786",
    "username": "Wesley",
    "realName": "金大森",
    "idNo": "A123456789",
    "email": "ist83903@bcaoo.com",
    "phoneNo": "0932166777",
    "birthday": "1988/12/12",
    "memberType": "personal",
    "verifyLevel": "3",
    "addresses": [
      {
        "zip3": 104,
        "city": "臺北市",
        "town": "中山區",
        "village": "正得里",
        "street": "吉林路",
        "usageType": "0",
        "seq": 1,
        "priority": true
      }
    ],
    "residentAddress": "臺北市中山區吉林路 69 號 4 樓",
    "citizen": true,
    "nativePeople": false,
    "cityInternetUid": ""
  }
}
launch_map

Web Call Example ​

json
{
  "name": "launch_map",
  "data": "https://maps.app.goo.gl/sQKx4n3WctXuS5Bw8"
}

App return ​

  • bool: Can the map feature be enabled?

App return example ​

json
{
  "name": "launch_map",
  "data": true
}
phone_call

Web Call Example ​

json
{
  "name": "phone_call",
  "data": "02-1234-5678"
}

App return ​

  • bool: Can the phone feature be enabled?

App return example ​

json
{
  "name": "phone_call",
  "data": bool
}
location

Web Call Example ​

json
{
  "name": "location",
  "data": null
}

App return ​

Position See details GeoLocator - Position

  • accuracy: Horizontal Accuracy (meters)
    double

  • altitude: Altitude (meters)
    double

  • altitudeaccuracy: Altitude Accuracy (meters)
    _double

  • floor: Floor
    int, nullable

  • heading: Heading While Moving
    double

  • headingaccuracy: Heading Accuracy While Moving (degrees)
    _double

  • ismocked: Is this simulated location data (Android API level 18 and later)
    _bool

  • latitude: Latitude (-90.0 inclusive to +90.0 inclusive)
    double

  • longitude: Longitude (-180.0 exclusive to +180.0 inclusive)
    double

  • speed: Speed (meters/second)
    double

  • speedaccuracy: Speed Accuracy (meters/second)
    _double

  • timestamp: Current Data Acquisition Time (ms)
    int

App return example ​

json
{
  "name": "location",
  "data": {
    "longitude": -121.406417,
    "latitude": 38.785834,
    "timestamp": 1724466344054,
    "accuracy": 5.0,
    "altitude": 0.0,
    "altitude_accuracy": 0.0,
    "floor": null,
    "heading": -1.0,
    "heading_accuracy": -1.0,
    "speed": 0.0,
    "speed_accuracy": 0.0,
    "is_mocked": true
  }
}
deviceinfo

Web Call Example ​

json
{
  "name": "deviceinfo",
  "data": null
}

App return example ​

ios

For reference: UIDevice, utsname

json
{
  "systemName": "iOS",
  "isPhysicalDevice": false,
  "utsname": {
    "release": "23.6.0",
    "sysname": "Darwin",
    "nodename": "xxx-MBP",
    "machine": "iPhone16,1",
    "version": "Darwin Kernel Version xxx: ..."
  },
  "model": "iPhone",
  "localizedModel": "iPhone",
  "systemVersion": "17.x",
  "name": "iPhone xxx",
  "identifierForVendor": "xxx-xxx-xxxx-..."
}
android

For reference: android.os.Build

json
{
  "product": "sdk_gphone64_arm64",
  "supportedAbis": [
    "arm64-v8a"
  ],
  "serialNumber": "unknown",
  "supported32BitAbis": [],
  "display": "AP31.xxxx.xxx",
  "type": "user",
  "isPhysicalDevice": false,
  "version": {
    "baseOS": "",
    "securityPatch": "2024-xx-xx",
    "sdkInt": 34,
    "release": "14",
    "codename": "VanillaIceCream",
    "previewSdkInt": 1,
    "incremental": "11566045"
  },
  "systemFeatures": [
    "android.hardware.sensor.proximity",
    "android.software.adoptable_storage",
    ...
  ],
  "manufacturer": "Google",
  "tags": "release-keys",
  "supported64BitAbis": [
    "arm64-v8a"
  ],
  "bootloader": "unknown",
  "fingerprint": "google/sdk_gphone64_arm64/...",
  "host": "x-xxx-...",
  "isLowRamDevice": false,
  "model": "sdk_gphone64_arm64",
  "id": "AP31.xxxx.xxx",
  "brand": "google",
  "device": "emu64a",
  "board": "goldfish_arm64",
  "hardware": "xxxxxx"
}
notify

Web Call Example ​

json
{
  "title": "Subscription",
  "content": "xxx subscription cancelled"
}

App return ​

  • bool: Whether the notification being sent or not.

App return example ​

json
{
  "name": "notify",
  "data": true
}