BuildVehicleModel

Trains Media Server to recognize a vehicle model.

You can only run this action after creating a vehicle model (using the action NewVehicleModel), and adding suitable images (using the action AddVehicleModelImages). For a step-by-step guide that demonstrates how to train vehicle model recognition, see Train Vehicle Model Recognition.

Type: asynchronous

Parameter Description Required
database The name of the database that contains the vehicle model. Yes
identifier The identifier of the model that you want to train Media Server to recognize. Yes
numparallel

The maximum number of threads to use to complete the training (default 1), subject to the limit specified by MaxNumParallel.

No

Example

/action=BuildVehicleModel&database=Cars&identifier=LanciaStratos

Response

This action is asynchronous, so Media Server always returns success accompanied by a token. You can use this token with the QueueInfo action to retrieve the status of your request.

<autnresponse>
  <action>QUEUEINFO</action>
  <response>SUCCESS</response>
  <responsedata>
    <actions>
      <action>
        <status>Finished</status>
        <queued_time>2016-Sep-15 18:13:07</queued_time>
        <time_in_queue>1</time_in_queue>
        <process_start_time>2016-Sep-15 18:13:08</process_start_time>
        <time_processing>0</time_processing>
        <process_end_time>2016-Sep-15 18:13:08</process_end_time>
        <build>
          <image>
            <index>1</index>
            <label>image1</label>
            <status>trained</status>
            <hasimagedata>true</hasimagedata>
            <vehicle>
              <plate>
                <readregion>
                  <point>
                    <x>274</x>
                    <y>282</y>
                  </point>
                  <point>
                    <x>367</x>
                    <y>282</y>
                  </point>
                  <point>
                    <x>367</x>
                    <y>297</y>
                  </point>
                  <point>
                    <x>274</x>
                    <y>297</y>
                  </point>
                </readregion>
                <plateregion>
                  <point>
                    <x>273</x>
                    <y>280</y>
                  </point>
                  <point>
                    <x>370</x>
                    <y>280</y>
                  </point>
                  <point>
                    <x>370</x>
                    <y>299</y>
                  </point>
                  <point>
                    <x>272</x>
                    <y>299</y>
                  </point>
                </plateregion>
                <plateread>...</plateread>
                <platetype>Regular</platetype>
                <country>DE</country>
              </plate>
              <grillepatch>
                <point>
                  <x>179</x>
                  <y>200</y>
                </point>
                <point>
                  <x>463</x>
                  <y>200</y>
                </point>
                <point>
                  <x>463</x>
                  <y>282</y>
                </point>
                <point>
                  <x>179</x>
                  <y>282</y>
                </point>
              </grillepatch>
              <grillepercentage>100</grillepercentage>
            </vehicle>
          </image>
        </build>
        <database>Cars</database>
        <identifier>LanciaStratos</identifier>
        <numimages>1</numimages>
        <numtrained>1</numtrained>
        <token>MTAuMi4xMDQuNTQ6MTgwMDA6VFJBSU5GQUNFOjE0MjkyNzE0NjAwMDQ1Ni0xMzAyMzQ3MDI2</token>
      </action>
    </actions>
  </responsedata>
</autnresponse>