API: updateLocations
Bryan Nye avatar
Written by Bryan Nye
Updated over a week ago

To update locations in bulk, use the MetaLocator.updateLocations API method. This method will *update* records that match based on exact match of the following fields:

  • Address

  • City

  • State

  • PostalCode

  • Country

During the import process, if the system encounters a record that matches the above criteria *exactly*, it will update that record with the data provided in the API call. If the system does not find an existing record it will be added to the database.

MetaLocator.updateLocations

Use our API Test tool to obtain the latest documentation on this and other API methods.

Username (String) : Your MetaLocator Username
Password (String) : Your MetaLocator Password
Struct (String): A structure representing the CSV rows as described below.

The Struct for import follows the same rules as the CSV import system.

Each API call can only have a total of 201 members within this parameter.  To upload more than 200 locations, call this method in succession with another set of 200 locations.  The "header" value must be provided with each call.  Also note that the member/name content must contain a unique row label, e.g row1, row2 as shown in the below example.

<struct>
   <member>
      <name>header</name>
      <value><string>Name,Description,Published,Address,Address2,City,State,PostalCode,Phone,Date,Country,Link,Email,language,lat,lng</string>
      </value>
   </member>
   <member>
      <name>row1</name>
      <value>
         <string>Sample Location 1,,1,2301 MetaLocator Way,,Denver,Colorado,80205,303-325-5912,,United States,,,en-US,,,,,</string>
      </value>
   </member>
<member>
      <name>row2</name>
      <value>
         <string>Sample Location 2,,1,2301 MetaLocator Way,,Denver,Colorado,80205,303-325-5912,,United States,,,en-US,,,,,</string>
      </value>
   </member>
   ...
<member>
      <name>rowN</name>
      <value>
         <string>Sample Location N,,1,2301 MetaLocator Way,,Denver,Colorado,80205,303-325-5912,,United States,,,en-US,,,,,</string>
      </value>
   </member>
</struct>
Did this answer your question?