|
1 | | -# AiBcrApi (EmailCloud.ai.bcr) |
2 | | - |
3 | | -AI Business card recognition operations. |
| 1 | +# AiBcrApi |
4 | 2 |
|
| 3 | + |
5 | 4 | <a name="parse"></a> |
6 | | -## **parse** |
7 | | - |
8 | | -Description: Parse images to vCard document models |
9 | | - |
10 | | -Returns: List of vCards |
11 | | - |
12 | | -Method call example: |
| 5 | +# **parse** |
13 | 6 | ```typescript |
14 | | -let result = await api.ai.bcr.parse(request); |
| 7 | +public async parse(request: AiBcrParseRequest): Promise< ContactList > |
15 | 8 | ``` |
16 | 9 |
|
17 | | -### Parameter: request |
18 | | - |
19 | | -Description: parse method request. |
20 | | - |
21 | | -See parameter model documentation at [AiBcrParseRequest](AiBcrParseRequest.md). |
| 10 | +Parse images to vCard document models |
22 | 11 |
|
23 | | -<details> |
24 | | - <summary>Parameter initialization example:</summary> |
25 | | - |
| 12 | +### Request Parameters |
26 | 13 | ```typescript |
27 | | -let request = Models.AiBcrParseRequest() |
28 | | - .file(fs.readFileSync('/path/to/image.png')) |
29 | | - .countries('us') |
30 | | - .languages('en') |
31 | | - .isSingle(true) |
32 | | - .build(); |
| 14 | +new AiBcrParse( |
| 15 | + file, |
| 16 | + countries=countries, |
| 17 | + languages=languages, |
| 18 | + isSingle=isSingle) |
33 | 19 | ``` |
34 | 20 |
|
35 | | -</details> |
| 21 | +Name | Type | Description | Notes |
| 22 | +---- | ---- | ----------- | ----- |
| 23 | + **file** | **byte[]**| File to parse | |
| 24 | + **countries** | **string**| Comma-separated codes of countries. | [optional] [default to ] |
| 25 | + **languages** | **string**| Comma-separated ISO-639 codes of languages (either 639-1 or 639-3; i.e. \"it\" or \"ita\" for Italian); it's \"\" by default. | [optional] [default to ] |
| 26 | + **isSingle** | **boolean**| Determines that image contains single VCard or more. | [optional] [default to true] |
36 | 27 |
|
37 | | -### Result |
38 | | - |
39 | | -Description: List of vCards |
40 | | - |
41 | | -Return type: Promise< [ContactList](ContactList.md) > |
42 | | - |
43 | | -<details> |
44 | | - <summary>Result example</summary> |
45 | | - |
46 | | -```typescript |
47 | | -let result = Models.contactList() |
48 | | - .value([ |
49 | | - Models.contactDto() |
50 | | - .attachments([ |
51 | | - Models.attachment() |
52 | | - .name('attachment.txt') |
53 | | - .base64Data('U29tZSBmaWxlIGNvbnRlbnQ=') |
54 | | - .build()]) |
55 | | - .displayName('Alex Thomas') |
56 | | - .emailAddresses([ |
57 | | - Models.emailAddress() |
58 | | - .category(Models.enumWithCustomOfEmailAddressCategory() |
59 | | - .value('Custom') |
60 | | - .description('Partners') |
61 | | - .build()) |
62 | | - .displayName('Alex Thomas Partners') |
63 | | - .preferred(true) |
64 | | - .address('email@aspose.com') |
65 | | - .build()]) |
66 | | - .gender('Male') |
67 | | - .givenName('Alex') |
68 | | - .phoneNumbers([ |
69 | | - Models.phoneNumber() |
70 | | - .category(Models.enumWithCustomOfPhoneNumberCategory() |
71 | | - .value('Office') |
72 | | - .build()) |
73 | | - .number('+49 211 4247 21') |
74 | | - .preferred(true) |
75 | | - .build()]) |
76 | | - .profession('GENERAL DIRECTOR') |
77 | | - .surname('Thomas') |
78 | | - .urls([ |
79 | | - Models.url() |
80 | | - .category(Models.enumWithCustomOfUrlCategory() |
81 | | - .value('Work') |
82 | | - .build()) |
83 | | - .preferred(true) |
84 | | - .href('www.aspose.com') |
85 | | - .build()]) |
86 | | - .build()]) |
87 | | - .build(); |
88 | | -``` |
| 28 | +### Return type |
89 | 29 |
|
90 | | -</details> |
91 | | - |
92 | | - |
93 | | -### Complete example |
94 | | - |
95 | | -<details> |
96 | | - <summary>Method call example:</summary> |
97 | | - |
98 | | -```typescript |
99 | | -const api = new EmailCloud(app_key, app_sid); |
100 | | - |
101 | | -// Prepare parameters: |
102 | | -let request = Models.AiBcrParseRequest() |
103 | | - .file(fs.readFileSync('/path/to/image.png')) |
104 | | - .countries('us') |
105 | | - .languages('en') |
106 | | - .isSingle(true) |
107 | | - .build(); |
108 | | - |
109 | | -// Call method: |
110 | | -let result = await api.ai.bcr.parse(request); |
111 | | - |
112 | | -// Result example: |
113 | | -result = Models.contactList() |
114 | | - .value([ |
115 | | - Models.contactDto() |
116 | | - .attachments([ |
117 | | - Models.attachment() |
118 | | - .name('attachment.txt') |
119 | | - .base64Data('U29tZSBmaWxlIGNvbnRlbnQ=') |
120 | | - .build()]) |
121 | | - .displayName('Alex Thomas') |
122 | | - .emailAddresses([ |
123 | | - Models.emailAddress() |
124 | | - .category(Models.enumWithCustomOfEmailAddressCategory() |
125 | | - .value('Custom') |
126 | | - .description('Partners') |
127 | | - .build()) |
128 | | - .displayName('Alex Thomas Partners') |
129 | | - .preferred(true) |
130 | | - .address('email@aspose.com') |
131 | | - .build()]) |
132 | | - .gender('Male') |
133 | | - .givenName('Alex') |
134 | | - .phoneNumbers([ |
135 | | - Models.phoneNumber() |
136 | | - .category(Models.enumWithCustomOfPhoneNumberCategory() |
137 | | - .value('Office') |
138 | | - .build()) |
139 | | - .number('+49 211 4247 21') |
140 | | - .preferred(true) |
141 | | - .build()]) |
142 | | - .profession('GENERAL DIRECTOR') |
143 | | - .surname('Thomas') |
144 | | - .urls([ |
145 | | - Models.url() |
146 | | - .category(Models.enumWithCustomOfUrlCategory() |
147 | | - .value('Work') |
148 | | - .build()) |
149 | | - .preferred(true) |
150 | | - .href('www.aspose.com') |
151 | | - .build()]) |
152 | | - .build()]) |
153 | | - .build(); |
154 | | -``` |
155 | | - |
156 | | -</details> |
| 30 | +Promise< [ContactList](ContactList.md) > |
157 | 31 |
|
158 | 32 | [[Back to top]](#) [[Back to Model list]](Models.md) [[Back to API README]](README.md) |
159 | | - |
| 33 | + |
160 | 34 | <a name="parseStorage"></a> |
161 | | -## **parseStorage** |
162 | | - |
163 | | -Description: Parse images from storage to vCard files |
164 | | - |
165 | | -Returns: List of vCard files located on storage |
166 | | - |
167 | | -Method call example: |
| 35 | +# **parseStorage** |
168 | 36 | ```typescript |
169 | | -let result = await api.ai.bcr.parseStorage(request); |
| 37 | +public async parseStorage(request: model.AiBcrParseStorageRequest): Promise< StorageFileLocationList > |
170 | 38 | ``` |
171 | 39 |
|
172 | | -### Parameter: request |
| 40 | +Parse images from storage to vCard files |
173 | 41 |
|
174 | | -Description: Request with images located on storage |
| 42 | +### request Parameter |
175 | 43 |
|
176 | 44 | See parameter model documentation at [AiBcrParseStorageRequest](AiBcrParseStorageRequest.md) |
177 | 45 |
|
178 | | -<details> |
179 | | - <summary>Parameter initialization example:</summary> |
180 | | - |
181 | | -```typescript |
182 | | -let request = Models.aiBcrParseStorageRequest() |
183 | | - .outFolder(Models.storageFolderLocation() |
184 | | - .storage('First Storage') |
185 | | - .folderPath('VCard/files/produced/by/parser/will/be/placed/here') |
186 | | - .build()) |
187 | | - .images([ |
188 | | - Models.aiBcrImageStorageFile() |
189 | | - .file(Models.storageFileLocation() |
190 | | - .fileName('VCardScanImage.jpg') |
191 | | - .storage('First Storage') |
192 | | - .folderPath('image/location/on/storage') |
193 | | - .build()) |
194 | | - .isSingle(true) |
195 | | - .build()]) |
196 | | - .build(); |
197 | | -``` |
198 | | - |
199 | | -</details> |
200 | | - |
201 | | -### Result |
202 | | - |
203 | | -Description: List of vCard files located on storage |
204 | | - |
205 | | -Return type: Promise< [StorageFileLocationList](StorageFileLocationList.md) > |
206 | | - |
207 | | -<details> |
208 | | - <summary>Result example</summary> |
209 | | - |
210 | | -```typescript |
211 | | -let result = Models.storageFileLocationList() |
212 | | - .value([ |
213 | | - Models.storageFileLocation() |
214 | | - .fileName('fileOnStorage.txt') |
215 | | - .storage('First Storage') |
216 | | - .folderPath('file/location/folder/on/storage') |
217 | | - .build()]) |
218 | | - .build(); |
219 | | -``` |
220 | | - |
221 | | -</details> |
222 | | - |
223 | | - |
224 | | -### Complete example |
225 | | - |
226 | | -<details> |
227 | | - <summary>Method call example:</summary> |
228 | | - |
229 | | -```typescript |
230 | | -const api = new EmailCloud(app_key, app_sid); |
231 | | - |
232 | | -// Prepare parameters: |
233 | | -let request = Models.aiBcrParseStorageRequest() |
234 | | - .outFolder(Models.storageFolderLocation() |
235 | | - .storage('First Storage') |
236 | | - .folderPath('VCard/files/produced/by/parser/will/be/placed/here') |
237 | | - .build()) |
238 | | - .images([ |
239 | | - Models.aiBcrImageStorageFile() |
240 | | - .file(Models.storageFileLocation() |
241 | | - .fileName('VCardScanImage.jpg') |
242 | | - .storage('First Storage') |
243 | | - .folderPath('image/location/on/storage') |
244 | | - .build()) |
245 | | - .isSingle(true) |
246 | | - .build()]) |
247 | | - .build(); |
248 | | - |
249 | | -// Call method: |
250 | | -let result = await api.ai.bcr.parseStorage(request); |
251 | | - |
252 | | -// Result example: |
253 | | -result = Models.storageFileLocationList() |
254 | | - .value([ |
255 | | - Models.storageFileLocation() |
256 | | - .fileName('fileOnStorage.txt') |
257 | | - .storage('First Storage') |
258 | | - .folderPath('file/location/folder/on/storage') |
259 | | - .build()]) |
260 | | - .build(); |
261 | | -``` |
| 46 | +### Return type |
262 | 47 |
|
263 | | -</details> |
| 48 | +Promise< [StorageFileLocationList](StorageFileLocationList.md) > |
264 | 49 |
|
265 | 50 | [[Back to top]](#) [[Back to Model list]](Models.md) [[Back to API README]](README.md) |
266 | 51 |
|
0 commit comments