Updated on 2024-03-22 GMT+08:00

Myanmar ID Card

Function

This API detects and extracts text from Myanmar-issued national registration cards and converts the text into a structured format. For details about the constraints on using this API, see Constraints and Limitations. For details about how to use this API, see Introduction to OCR.

Figure 1 Example Myanmar ID card

Constraints and Limitations

  • Only images in PNG, JPG, JPEG, BMP, or TIFF format can be recognized.
  • No side of the image can be smaller than 15 or larger than 8,000 pixels.
  • An ID card to be recognized must occupy more than 25% of the image. When scanning an ID card, ensure that the entire ID card is displayed in the image.
  • An ID card can be rotated to any angle.
  • The ID card in the image can be moderately distorted, but the aspect ratio cannot be distorted by more than 10%.
  • Illuminated or dark images can be recognized, but the accuracy may be compromised.
  • Only the front or back of a single ID card can be identified each time.

Calling Method

For details, see Calling APIs.

Prerequisites

Before using this API, subscribe to the service and complete authentication. For details, see Subscribing to an OCR Service and Authentication.

Before using the service for the first time, you need to enable the service by clicking Subscribe. You only need to subscribe to the service once. If you have not subscribed to the service yet, error "ModelArts.4204" will be displayed when you call this API. Before you call the API, log in to the OCR console and subscribe to the corresponding service. Ensure that you make the subscription to the service in the same region where you want to call this API.

URI

POST /v2/{project_id}/ocr/myanmar-id-card

Table 1 URI parameters

Parameter

Mandatory

Description

endpoint

Yes

Endpoint, which is the request address for calling an API.

The endpoint varies depending on services in different regions. For more details, see Endpoints.

project_id

Yes

Project ID, which can be obtained by referring to Obtaining a Project ID.

Enterprise-Project-Id

No

Enterprise project ID. OCR uses Enterprise Project Management Service (EPS) to split fees for resources used by different user groups and users.

To obtain the enterprise project ID, go to the Enterprise Project Management console, click the enterprise project name, and obtain the enterprise project ID on the enterprise project details page.

For details about how to create an enterprise project, see Optical Character Recognition User Guide.

NOTE:

After an enterprise project is created, parameter transfer involves the following scenarios:

  • If a correct enterprise project ID is carried and the OCR service can be used properly, the bills are allocated to the enterprise project corresponding to the ID.
  • If an incorrect enterprise project ID is carried and the OCR service can be used properly, the enterprise project in the bills is allocated to Non-project.
  • If no enterprise project ID is carried and the OCR service can be used properly, the enterprise project in the bills is allocated to Non-project.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token

Used to obtain the permission to call APIs. The token is the value of X-Subject-Token in the response header in Authentication.

Content-Type

Yes

String

MIME type of the request body. The value is application/json.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

image

No

String

Set either this parameter or url.

Base64 encoded string of an image file. The image file has a size limit of 10 MB.

No side of the image can be smaller than 15 or larger than 8,000 pixels. Only images in JPEG, JPG, PNG, BMP, or TIFF format can be recognized.

An example is /9j/4AAQSkZJRgABAg.... If the image data contains an unnecessary prefix, the error "The image format is not supported" is reported.

url

No

String

Set either this parameter or image.

Image URL. Currently, the following URLs are supported:

  • Public HTTP/HTTPS URL
  • URL provided by OBS. You need to be authorized to use OBS data, including service authorization, temporary authorization, and anonymous public authorization. For details, see Configuring Access Permissions of OBS.
NOTE:
  • The API response time depends on the image download time. If the image download takes a long time, the API call will fail.
  • Ensure that the storage service where the image to be detected resides is stable and reliable. OBS is recommended for storing image data.

convert_unicode

No

Boolean

Output format. The options are as follows:

  • true: The output will be in the Unicode format.
  • false: The output will be in the zawgyi format.

If this parameter is not specified or does not exist, the output will be in the zawgyi format by default.

return_confidence

No

Boolean

Whether to return the confidence. The options are as follows:

true: The confidence will be returned.

false: The confidence will not be returned.

If this parameter is not specified, the system does not return the confidence by default. If a non-Boolean value is entered, an error message will be displayed, indicating that the parameter is invalid.

return_portrait_image

No

Boolean

Whether to return the Base64 code of the portrait on the ID card image. The options are as follows:

  • true: The Base64 code of the portrait on the ID card will be returned.
  • false: The Base64 code of the portrait on the ID card will not be returned.

If this parameter is not specified, false is used by default. In this case, the Base64 code of the portrait on the ID card will not be returned.

return_portrait_location

No

Boolean

Whether to return the location of the portrait on the ID card image. The options are as follows:

  • true: The location of the portrait on the ID card will be returned.
  • false: The location of the portrait on the ID card will not be returned.

return_idcard_type

No

Boolean

Whether to return the ID card type. The options are as follows:

  • true: The ID card type, either original or copy of the original will be returned.
  • false: The ID card type will not be returned.

return_translation

No

Boolean

Whether to return translation information. The options are as follows:

  • true: The translation information is returned.
  • false: The translation information is not returned.

Response Parameters

Status code: 200

Table 4 Response body parameter

Parameter

Type

Description

result

MyanmarIdcardResult object

Calling result

This parameter is not returned when the API fails to be called.

Table 5 MyanmarIdcardResult

Parameter

Type

Description

side

String

Front or back of a national registration card. The options are front and back.

class

String

ID card type. The options are as follows:

  • new_version: new version of ID card
  • old_version: old version of ID card

nrc_id

String

ID number

issue_date

String

Date of issue

name

String

Name

father_name

String

Father's name

birth

String

Date of birth

bloodlines_religion

String

Ethnic group or religion

height

String

Height

blood_group

String

Blood type

card_id

String

Card number on the back of the ID card

nrc_id_back

String

ID number on the back of the ID card

profession

String

Occupation

address

String

Address

confidence

MyanmarIdcardConfidence object

Confidence of a field. The value ranges from 0 to 1.

A higher confidence indicates a higher accuracy of the field identified. The confidence is calculated using algorithms and is not equal to the accuracy.

portrait_image

String

Base64 code of the portrait. This parameter is returned only when return_portrait_image is set to true.

portrait_location

Array<Array<Integer>>

Location of the portrait on the original image. This parameter is returned only when return_portrait_location is set to true. The image is displayed in a list. The list contains the two-dimensional coordinates (x,y) of the four vertices in the portrait area. The origin of the coordinates is the upper left corner of the image. The X axis is horizontal, and the Y axis is vertical.

idcard_type

String

ID card type. This parameter is returned only when return_idcard_type is set to true. The options are as follows:

  • normal: original ID card
  • copy: copy of the ID card

translation_info

MyanmarIdcardTranslationInfo object

Translation information. This parameter is returned only when return_translation is set to true. This field contains information about name_translation and nrc_id_translation. When no appropriate translation fields can be found, the original Burmese characters are retained.

Table 6 MyanmarIdcardConfidence

Parameter

Type

Description

nrc_id

Float

Confidence of the ID number

issue_date

Float

Confidence of the issuance date

name

Float

Confidence of the name

birth

Float

Confidence of the birth date

bloodlines_religion

Float

Confidence of the ethnic group or religion

height

Float

Confidence of the height

blood_group

Float

Confidence of the blood type

card_id

Float

Confidence of the card number on the back of the ID card

nrc_id_back

Float

ID number on the back of the ID card

profession

Float

Confidence of the occupation

address

Float

Confidence of the address

Table 7 MyanmarIdcardTranslationInfo

Parameter

Type

Description

name_translation

String

Name translation. This parameter is returned only when return_translation is set to true.

father_name_translation

String

Translation of the father's name. This parameter is returned only when return_translation is set to true.

nrc_id_translation

String

Translation of the ID number. This parameter is returned only when return_translation is set to true.

birth_translation

String

Birth date translation. This parameter is returned only when return_translation is set to true.

Status code: 400

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error code of a failed API call. For details, see Error Codes.

If error code ModelArts.4204 is displayed, refer to Why Is a Message Stating "ModelArts.4204" Displayed When the OCR API Is Called?

This parameter is not returned when the API is successfully called.

error_msg

String

Error message when the API call fails

This parameter is not returned when the API is successfully called.

Example Request

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

    For example, Myanmar ID Card OCR is deployed in the CN-Hong Kong region. The endpoint is ocr.ap-southeast-1.myhuaweicloud.com or ocr.ap-southeast-1.myhuaweicloud.cn. The request URL is https://ocr.ap-southeast-1.myhuaweicloud.com/v2/{project_id}/ocr/myanmar-id-card. 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 Base64 encoded string of an image.)
    POST https://{endpoint}/v2/{project_id}/ocr/myanmar-id-card
    
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
    Request Body: 
    {
        "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAd...",
        "convert_unicode": true,
        "return_confidence": true,
        "return_portrait_image": true,
        "return_portrait_location": true,
        "return_idcard_type": true
    }
  • Request example (Method 2: Use the image URL.)
    POST https://{endpoint}/v2/{project_id}/ocr/myanmar-id-card
    
    Request Header:
    Content-Type: application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
    Request Body: 
    {
        "url":"https://BucketName.obs.xxxx.com/ObjectName",
        "convert_unicode": true,
        "return_confidence": true,
        "return_portrait_image": true,
        "return_portrait_location": true,
        "return_idcard_type": true
    }
  • 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/myanmar-id-card"
    token = "Actual token value obtained by the user"
    headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}
    
    imagepath = r'./data/myanmar-id-card-demo.png'  # Read a local image.
    with open(imagepath, "rb") as bin_data:
        image_data = bin_data.read()
    image_base64 = base64.b64encode(image_data).decode("utf-8")  # Use the Base64 code of the image.
    payload = {"image": image_base64}
    response = requests.post(url, headers=headers, json=payload)
    print(response.text)

Example Response

Status code: 200

Example response for a successful request (the front)

{ 
  "result" : { 
    "side" : "front", 
    "nrc_id" : "XXXXXXXX", 
    "issue_date" : "၂၀.၉.၂၀၁၁", 
    "name" : "XXXX", 
    "father_name" : "XXX", 
    "birth" : "၁၄.၁၀.၁၉၉၁", 
    "bloodlines_religion" : "ဗမာ၊ဗုဒ္ဓ", 
    "height" : "၅'၅\"", 
    "blood_group" : "ဘီ", 
    "class" : "new_version", 
    "confidence" : { 
      "nrc_id" : 0.7514, 
      "issue_date" : 0.5385, 
      "name" : 0.6641, 
      "birth" : 0.5216, 
      "bloodlines_religion" : 0.9774, 
      "height" : 0.7526, 
      "blood_group" : 0.7541 
    }, 
    "portrait_image" : "/9j/4AA... ", 
    "portrait_location" : [ [ 106, 178 ], [ 369, 181 ], [ 366, 448 ], [ 108, 445 ] ], 
    "idcard_type" : "normal", 
    "translation_info" : { 
      "name_translation" : "Ma Sandar Phy", 
      "father_name_translation" : "U Thein Po", 
      "birth_translation" : "7.5.1992", 
      "nrc_id_translation" : "9/MaKhaNa(C)251959" 
    } 
  } 
}

Successful response example (the back)

{
    "result":{
        "side": "back", 
        "card_id": "XXXXXXX", 
        "nrc_id_back": "", 
        "profession": "ကျောင်းသား", 
        "address": "XXXXXXXX", 
        "class": "new_version", 
        "confidence": {
            "card_id": 0.9878, 
            "nrc_id_back": 0.9595, 
            "profession": 0.9995, 
            "address": 0.9299
        },
        "idcard_type": "normal"    
    }
}

Status code: 400

Example response for a failed request

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

Example SDK Code

The example SDK code is as follows:

  • Transfer the Base64 code of the Myanmar ID card image for recognition.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    package com.huaweicloud.sdk.test;
    
    import com.huaweicloud.sdk.core.auth.ICredential;
    import com.huaweicloud.sdk.core.auth.BasicCredentials;
    import com.huaweicloud.sdk.core.exception.ConnectionException;
    import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
    import com.huaweicloud.sdk.core.exception.ServiceResponseException;
    import com.huaweicloud.sdk.ocr.v1.region.OcrRegion;
    import com.huaweicloud.sdk.ocr.v1.*;
    import com.huaweicloud.sdk.ocr.v1.model.*;
    
    
    public class RecognizeMyanmarIdcardSolution {
    
        public static void main(String[] args) {
            // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
            // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
            String ak = System.getenv("CLOUD_SDK_AK");
            String sk = System.getenv("CLOUD_SDK_SK");
    
            ICredential auth = new BasicCredentials()
                    .withAk(ak)
                    .withSk(sk);
    
            OcrClient client = OcrClient.newBuilder()
                    .withCredential(auth)
                    .withRegion(OcrRegion.valueOf("<YOUR REGION>"))
                    .build();
            RecognizeMyanmarIdcardRequest request = new RecognizeMyanmarIdcardRequest();
            MyanmarIdcardRequestBody body = new MyanmarIdcardRequestBody();
            body.withReturnIdcardType(true);
            body.withReturnPortraitLocation(true);
            body.withReturnPortraitImage(true);
            body.withReturnConfidence(true);
            body.withConvertUnicode(true);
            body.withImage("/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...");
            request.withBody(body);
            try {
                RecognizeMyanmarIdcardResponse response = client.recognizeMyanmarIdcard(request);
                System.out.println(response.toString());
            } catch (ConnectionException e) {
                e.printStackTrace();
            } catch (RequestTimeoutException e) {
                e.printStackTrace();
            } catch (ServiceResponseException e) {
                e.printStackTrace();
                System.out.println(e.getHttpStatusCode());
                System.out.println(e.getRequestId());
                System.out.println(e.getErrorCode());
                System.out.println(e.getErrorMsg());
            }
        }
    }
    
  • Transfer the URL of the Myanmar ID card image for recognition.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    package com.huaweicloud.sdk.test;
    
    import com.huaweicloud.sdk.core.auth.ICredential;
    import com.huaweicloud.sdk.core.auth.BasicCredentials;
    import com.huaweicloud.sdk.core.exception.ConnectionException;
    import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
    import com.huaweicloud.sdk.core.exception.ServiceResponseException;
    import com.huaweicloud.sdk.ocr.v1.region.OcrRegion;
    import com.huaweicloud.sdk.ocr.v1.*;
    import com.huaweicloud.sdk.ocr.v1.model.*;
    
    
    public class RecognizeMyanmarIdcardSolution {
    
        public static void main(String[] args) {
            // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
            // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
            String ak = System.getenv("CLOUD_SDK_AK");
            String sk = System.getenv("CLOUD_SDK_SK");
    
            ICredential auth = new BasicCredentials()
                    .withAk(ak)
                    .withSk(sk);
    
            OcrClient client = OcrClient.newBuilder()
                    .withCredential(auth)
                    .withRegion(OcrRegion.valueOf("<YOUR REGION>"))
                    .build();
            RecognizeMyanmarIdcardRequest request = new RecognizeMyanmarIdcardRequest();
            MyanmarIdcardRequestBody body = new MyanmarIdcardRequestBody();
            body.withReturnIdcardType(true);
            body.withReturnPortraitLocation(true);
            body.withReturnPortraitImage(true);
            body.withReturnConfidence(true);
            body.withConvertUnicode(true);
            body.withUrl("https://BucketName.obs.myhuaweicloud.com/ObjectName");
            request.withBody(body);
            try {
                RecognizeMyanmarIdcardResponse response = client.recognizeMyanmarIdcard(request);
                System.out.println(response.toString());
            } catch (ConnectionException e) {
                e.printStackTrace();
            } catch (RequestTimeoutException e) {
                e.printStackTrace();
            } catch (ServiceResponseException e) {
                e.printStackTrace();
                System.out.println(e.getHttpStatusCode());
                System.out.println(e.getRequestId());
                System.out.println(e.getErrorCode());
                System.out.println(e.getErrorMsg());
            }
        }
    }
    
  • Transfer the Base64 code of the Myanmar ID card image for recognition.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    # coding: utf-8
    
    from huaweicloudsdkcore.auth.credentials import BasicCredentials
    from huaweicloudsdkocr.v1.region.ocr_region import OcrRegion
    from huaweicloudsdkcore.exceptions import exceptions
    from huaweicloudsdkocr.v1 import *
    
    if __name__ == "__main__":
        # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak = os.getenv("CLOUD_SDK_AK")
        sk = os.getenv("CLOUD_SDK_SK")
    
        credentials = BasicCredentials(ak, sk) \
    
        client = OcrClient.new_builder() \
            .with_credentials(credentials) \
            .with_region(OcrRegion.value_of("<YOUR REGION>")) \
            .build()
    
        try:
            request = RecognizeMyanmarIdcardRequest()
            request.body = MyanmarIdcardRequestBody(
                return_idcard_type=True,
                return_portrait_location=True,
                return_portrait_image=True,
                return_confidence=True,
                convert_unicode=True,
                image="/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
            )
            response = client.recognize_myanmar_idcard(request)
            print(response)
        except exceptions.ClientRequestException as e:
            print(e.status_code)
            print(e.request_id)
            print(e.error_code)
            print(e.error_msg)
    
  • Transfer the URL of the Myanmar ID card image for recognition.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    # coding: utf-8
    
    from huaweicloudsdkcore.auth.credentials import BasicCredentials
    from huaweicloudsdkocr.v1.region.ocr_region import OcrRegion
    from huaweicloudsdkcore.exceptions import exceptions
    from huaweicloudsdkocr.v1 import *
    
    if __name__ == "__main__":
        # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak = os.getenv("CLOUD_SDK_AK")
        sk = os.getenv("CLOUD_SDK_SK")
    
        credentials = BasicCredentials(ak, sk) \
    
        client = OcrClient.new_builder() \
            .with_credentials(credentials) \
            .with_region(OcrRegion.value_of("<YOUR REGION>")) \
            .build()
    
        try:
            request = RecognizeMyanmarIdcardRequest()
            request.body = MyanmarIdcardRequestBody(
                return_idcard_type=True,
                return_portrait_location=True,
                return_portrait_image=True,
                return_confidence=True,
                convert_unicode=True,
                url="https://BucketName.obs.myhuaweicloud.com/ObjectName"
            )
            response = client.recognize_myanmar_idcard(request)
            print(response)
        except exceptions.ClientRequestException as e:
            print(e.status_code)
            print(e.request_id)
            print(e.error_code)
            print(e.error_msg)
    
  • Transfer the Base64 code of the Myanmar ID card image for recognition.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    package main
    
    import (
    	"fmt"
    	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
        ocr "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1"
    	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/model"
        region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/region"
    )
    
    func main() {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak := os.Getenv("CLOUD_SDK_AK")
        sk := os.Getenv("CLOUD_SDK_SK")
    
        auth := basic.NewCredentialsBuilder().
            WithAk(ak).
            WithSk(sk).
            Build()
    
        client := ocr.NewOcrClient(
            ocr.OcrClientBuilder().
                WithRegion(region.ValueOf("<YOUR REGION>")).
                WithCredential(auth).
                Build())
    
        request := &model.RecognizeMyanmarIdcardRequest{}
    	returnIdcardTypeMyanmarIdcardRequestBody:= true
    	returnPortraitLocationMyanmarIdcardRequestBody:= true
    	returnPortraitImageMyanmarIdcardRequestBody:= true
    	returnConfidenceMyanmarIdcardRequestBody:= true
    	convertUnicodeMyanmarIdcardRequestBody:= true
    	imageMyanmarIdcardRequestBody:= "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
    	request.Body = &model.MyanmarIdcardRequestBody{
    		ReturnIdcardType: &returnIdcardTypeMyanmarIdcardRequestBody,
    		ReturnPortraitLocation: &returnPortraitLocationMyanmarIdcardRequestBody,
    		ReturnPortraitImage: &returnPortraitImageMyanmarIdcardRequestBody,
    		ReturnConfidence: &returnConfidenceMyanmarIdcardRequestBody,
    		ConvertUnicode: &convertUnicodeMyanmarIdcardRequestBody,
    		Image: &imageMyanmarIdcardRequestBody,
    	}
    	response, err := client.RecognizeMyanmarIdcard(request)
    	if err == nil {
            fmt.Printf("%+v\n", response)
        } else {
            fmt.Println(err)
        }
    }
    
  • Transfer the URL of the Myanmar ID card image for recognition.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    package main
    
    import (
    	"fmt"
    	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
        ocr "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1"
    	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/model"
        region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/ocr/v1/region"
    )
    
    func main() {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        ak := os.Getenv("CLOUD_SDK_AK")
        sk := os.Getenv("CLOUD_SDK_SK")
    
        auth := basic.NewCredentialsBuilder().
            WithAk(ak).
            WithSk(sk).
            Build()
    
        client := ocr.NewOcrClient(
            ocr.OcrClientBuilder().
                WithRegion(region.ValueOf("<YOUR REGION>")).
                WithCredential(auth).
                Build())
    
        request := &model.RecognizeMyanmarIdcardRequest{}
    	returnIdcardTypeMyanmarIdcardRequestBody:= true
    	returnPortraitLocationMyanmarIdcardRequestBody:= true
    	returnPortraitImageMyanmarIdcardRequestBody:= true
    	returnConfidenceMyanmarIdcardRequestBody:= true
    	convertUnicodeMyanmarIdcardRequestBody:= true
    	urlMyanmarIdcardRequestBody:= "https://BucketName.obs.myhuaweicloud.com/ObjectName"
    	request.Body = &model.MyanmarIdcardRequestBody{
    		ReturnIdcardType: &returnIdcardTypeMyanmarIdcardRequestBody,
    		ReturnPortraitLocation: &returnPortraitLocationMyanmarIdcardRequestBody,
    		ReturnPortraitImage: &returnPortraitImageMyanmarIdcardRequestBody,
    		ReturnConfidence: &returnConfidenceMyanmarIdcardRequestBody,
    		ConvertUnicode: &convertUnicodeMyanmarIdcardRequestBody,
    		Url: &urlMyanmarIdcardRequestBody,
    	}
    	response, err := client.RecognizeMyanmarIdcard(request)
    	if err == nil {
            fmt.Printf("%+v\n", response)
        } else {
            fmt.Println(err)
        }
    }
    

For more SDK code examples in various programming languages, see the Sample Code tab on the right of the API Explorer page, which can automatically generate corresponding SDK code examples.

Status Codes

Status Code

Description

200

Example response for a successful request

400

Example response for a failed request

See Status Codes.

Error Codes

See Error Codes.