{"id":10078,"date":"2023-11-19T09:00:20","date_gmt":"2023-11-19T09:00:20","guid":{"rendered":"https:\/\/brightworldlabs.com\/?page_id=10078"},"modified":"2025-10-15T17:55:37","modified_gmt":"2025-10-15T17:55:37","slug":"oncilla-api","status":"publish","type":"page","link":"https:\/\/brightworldlabs.com\/ar\/oncilla-api\/","title":{"rendered":"Oncilla API"},"content":{"rendered":"
\t\t
\n\t\t\t

Oncilla API | Location Intelligence | AWS<\/h1>\n\t\t<\/div>\n\t\t\n\t
\n\t\t\n\t\t
\n\t\t\t
\"line\"<\/div>\n\t\t<\/figure>\n\t<\/div>\n<\/div><\/div><\/div><\/div>
\t\t
\n\t\t\t

How to use the Oncilla API to geoparse your text.<\/h4>\n\t\t<\/div>\n\t\t<\/div><\/div><\/div><\/div>\t\t
\n\t\t\t\n\t\t\t\"Oncilla\n\t\t\t\t\t<\/div>\n\t\t\n\t
\n\t\t
\n\t\t\t

Step 1:<\/strong> Create an AWS IAM account<\/a>.<\/p>\n

Step 2:<\/strong> Subscribe to Oncilla in the AWS Marketplace<\/a>.<\/p>\n

Step 3:<\/strong> Configure your AWS credentials<\/a>.<\/p>\n

Step 4:<\/strong> Start using Oncilla!<\/p>\n\n\t\t<\/div>\n\t<\/div>\n<\/div><\/div><\/div><\/div>

\t\t
\n\t\t\t

Call the Oncilla API using the AWS CLI.<\/h4>\n
aws dataexchange send-api-asset \\\r\n--data-set-id 97b9c546368629960e63b8c0f6edbea9 \\\r\n--revision-id 16c060acfe4cc7cdf08c0ca499bc1093 \\\r\n--asset-id 5a779b06b6cfcdff958d4707afa6a5ae \\\r\n--method POST \\<br \/>--path \"\/geoparse\" \\\r\n--request-headers 'Content-Type=application\/json' \\\r\n--body \"[{\\\"recordId\\\": \\\"a1\\\", \\\"data\\\": {\\\"text\\\": \\\"Monsoon rains are forecast to continue over the deserts in the Southwest and up into the Rocky Mountains, with potential for flash flooding in Arizona, Utah, Colorado and Wyoming on Sunday.\\\", \\\"lang\\\": \\\"en\\\", \\\"informal\\\": false}}]\"<\/pre>\n\t\t<\/div>\n\t\t<\/div><\/div><\/div>
\n\t
\n\t\t
\n\t\t\t
Call the Oncilla API using Python code.<\/h4>\n
import json\r\nimport boto3\r\n\r\n\r\naws_client = boto3.client('dataexchange')\r\n\r\n\r\ndef geoparse(api_data, client):\r\n    response = client.send_api_asset(\r\n      DataSetId='97b9c546368629960e63b8c0f6edbea9',\r\n      RevisionId='16c060acfe4cc7cdf08c0ca499bc1093',\r\n      AssetId='5a779b06b6cfcdff958d4707afa6a5ae',\r\n      Method='POST',\r\n      Path='\/geoparse',\r\n      RequestHeaders={\r\n          'Content-Type': 'application\/json'\r\n      },\r\n      Body=json.dumps(api_data)\r\n    )\r\n    return response\r\n\r\n\r\napi_data = {\r\n  \"values\": [{\r\n      \"recordId\": 'a1',\r\n      \"data\": {\r\n        \"text\": 'Monsoon rains are forecast to continue over the deserts in the Southwest and up into the Rocky Mountains, with potential for flash flooding in Arizona, Utah, Colorado and Wyoming on Sunday.',\r\n        \"lang\": \"en\",\r\n        \"informal\": False\r\n      }\r\n    },\r\n    {\r\n      \"recordId\": 'a2',\r\n      \"data\": {\r\n        \"text\": 'The Africa CDC is based at the Africa CDC Coordinating Centre in Addis Ababa, Ethiopia, which also contains the agency\\'s Emergency Operations Centre.',\r\n        \"lang\": \"en\",\r\n        \"informal\": False\r\n      }\r\n    }]\r\n}\r\n\r\nresults = geoparse(api_data, aws_client)\r\noutput = json.loads(results['Body'].replace('\\\"', '\"'))\r\n# output contains the geoparsed results for the final batch\r\nprint(output)\r\n<\/pre>\n\n\t\t<\/div>\n\t<\/div>\n
<\/pre>\r\n