Function

Train Ticket OCR recognizes the text in a train ticket image and returns the structured result in JSON format. For details about the constraints on using this API, see Constraints. For details about how to use this API, see Introduction to OCR.

Currently, train ticket information cannot be recognized.

If the image contains multiple cards and tickets, call Auto Classification OCR.

Prerequisites

Before using Train Ticket OCR, you need to apply for the service and complete authentication. For details, see Subscribing to OCR and Authentication.

URI

POST https://{endpoint}/v2/{project_id}/ocr/train-ticket

Request Parameters

Response Parameters

Response parameters and status codes vary in different recognition results. They are described as below.

Status code: 200

Status code: 400

Request Example

• The endpoint is the request URL for calling an API. Endpoints vary depending on services and regions. For details, see Endpoints.

  For example, Train Ticket OCR is deployed in the CN North-Beijing4 region. The endpoint is ocr.cn-north-4.myhuaweicloud.com. The request URL is https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/train-ticket. project_id is the project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

• For details about how to obtain a token, see Making an API Request.

• Request example (Method 1: Use the image Base64 string.)

  POST  https://{endpoint}/v2/{project_id}/ocr/train-ticket
  Request Header:
  Content-Type: application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  Request Body: 
  {
      "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
  }

• Request example (Method 2: Use the image URL.)

  POST  https://{endpoint}/v2/{project_id}/ocr/train-ticket
  Request Header:
  Content-Type: application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  Request Body: 
  {
      "url":"https://BucketName.obs.xxxx.com/ObjectName"
  }

• Sample code for a Python 3 request (For codes in other languages, refer to the following sample or use OCR SDK.)

  # encoding:utf-8
  
  import requests
  import base64
  
  url = "https://{endpoint}/v2/{project_id}/ocr/train-ticket"
  token = "Actual token value obtained by the user"
  headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}
  
  imagepath = r'./data/train-ticket-demo.png'
  with open(imagepath, "rb") as bin_data:
      image_data = bin_data.read()
  image_base64 = base64.b64encode(image_data).decode("utf-8")  # Base64 encoding of images.
  payload = {"image": image_base64} # url or image.
  response = requests.post(url, headers=headers, json=payload)
  print(response.text)

Example Response

Status code: 200

Successful response example

{
    "result": {
        "ticket_id": "KXXXX", 
        "check_port": "BXX", 
        "train_number": "GXXX", 
        "departure_station": "Departure station recognized from the image",
        "destination_station": "Destination station recognized from the image",
        "departure_station_en": "Changshanan", 
        "destination_station_en": "xxxx", 
        "departure_time": "Departure time recognized from the image",
        "seat_number": "Seat number recognized from the image",
        "ticket_price": "164.5", 
        "sale_method": "Sale method recognized from the image",
        "seat_category": "Seat category recognized from the image",
        "ticket_changing": "No", 
        "id_number": "1402271998****0012", 
        "name": "Name recognized from the image",
        "log_id": "65818301991213K09XXXX", 
        "sale_location": "Sale location recognized from the image",
        "confidence": {
            "ticket_id": 0.9992, 
            "check_port": 0.9165, 
            "train_number": 0.9968, 
            "starting_station": 0.9982, 
            "destination_station": 0.9998, 
            "starting_station_en": 0.9254, 
            "destination_station_en": 0.9848, 
            "starting_time": 0.5141, 
            "seat_number": 0.9985, 
            "ticket_rates": 0.9977, 
            "sale_method": 0.9836, 
            "seat_category": 0.9958, 
            "ticket_changing": 0.9, 
            "id_number": 0.9986, 
            "name": 0.996, 
            "log_id": 0.9968, 
            "ticket_office": 0.9984
        }
    }
}

Status code: 400

Failure response example

{
    "error_code": "AIS.0103", 
    "error_msg": "The image size does not meet the requirements." 
}

Status Codes

For details about status codes, see Status Codes.

Error Codes

For details about error codes, see Error Codes.