Pointr Cloud API Troubleshooting¶
Content created or modified not reflected in REST API calls or SDK¶
Pointr Cloud has in general a two steps to create or modify any content, the first step is saving the content, sometimes this is automatic during the Dashboard usage for example, sometimes there is an explicit “save” button somewhere.
Even though the database stores the modified content, that content is not ready for use yet and won’t be handed to the SDK, and won’t be returned in REST API calls.
Solution¶
The solution for the issue is “publish” the modified content, one way is using the “Publish” button on the dashboard, whenever that button is highlighted it means there is unpublished content in the relevant section, for example if the map of a specific venue has the “Publish” button highlighted it means that venue had content modified.
The other way to “publish” content is using the REST API, there are endpoints that trigger a publish process, including one unique to the REST API and not available on the dashboard, called “Super Publish”, when calling the POST /publish
endpoint with no arguments, it triggers a “Super Publish” where all venues have a “publish” done on them.
Warning
Please avoid excess calls of “publish” on the API as too many overlapping calls might cause issues.
What do the error messages in MapScale operations mean and how should they be handled?¶
When jobs are submitted via POST /map-jobs
, sometimes the map job might fail due to different reasons. Different type of errors require different actions to be taken.
Solution¶
Please refer to the below table of the error messages that can be returned from the map jobs and possible troubleshooting steps for each type of message.
Error Message | Troubleshooting |
---|---|
Couldn’t find the DXF file on the storage blob. | MapScale Service couldn’t find the requested CAD file on the storage blob. Check the filename parameter and make sure the requested CAD file is actually located in the given blob. |
Azure Blob authentication failed. | Check the input public URL and SAS token parameters. |
Couldn’t read the CAD file, check the name of the file or CAD blob container details | Either the CAD file is broken or MapScale service can’t read the file from the blob. Make sure that the CAD file on the blob is a valid, readable CAD file. |
Not a valid DXF file! | The DXF file is not a valid one. Try to open the CAD file using a CAD software (AutoCAD, Autodesk Viewer) to make sure that the given file is a valid CAD file. |
Something went wrong in preparing the DXF file! | The DXF file should include some default headers. If these headers are missing, MapScale service will raise this error. Try to open the DXF file using AutoCAD and solve these errors by using AutoCAD’s troubleshooting methods. |
PDF file does not contain vector lines! | PDF file only contains images, not vector lines. MapScale service needs vectoral lines for processing, therefore it won’t process a PDF that only contains images. To check whether your PDF file is an image or vectoral one, follow this guide |
Something went wrong in the directory management state! | MapScale service couldn’t access/create the internal directories. Contact Pointr support. |
Something went wrong in pre processing state! | MapScale service failed during preparing the required objects like blocks, lines and texts. Check the CAD file using a CAD viewer software to find the objects that can cause errors. |
Something went wrong in the drawing state! | MapScale service failed during the rasterization process. Make sure the CAD file contains entities in the model space. |
Scale was wrong and couldn’t be fixed automatically. | The CAD file does not contain correct scale information, and it couldn’t be fixed automatically due to lack of furniture. In the absence of furniture, the scale of the CAD file can be manually corrected using CAD software. |
Size of the building is too large (>500m). | The size of the building exceeds the building size limit (500 meters in either of the dimensions). |
Something went wrong in the starting unit segmentation thread! | An error occurred while starting the segmentation process, either the segmentation service is not responding or MapScale service failed to create another subprocess. Contact Pointr support. |
Something went wrong in the building detection stage! | MapScale service failed during the building detection stage. Make sure there is actually a supported building type in the CAD file. For information on supported building types see here |
Something went wrong in the furniture detection state! | Furniture detection step failed. Contact Pointr support. |
Something went wrong while waiting for the unit segmentation thread to finish! | The segmentation process did not finish successfully. Contact Pointr support. |
Something went wrong in preparing DXF entities! | MapScale service failed during sampling/merging/grouping vector lines. Check the ARC, POLYLINE and LWPOLYLINE entities using a CAD software to find the objects that can cause errors. If everything looks fine, contact Pointr support. |
Something went wrong in the post processing unit state! | MapScale service failed during the unit segmentation post processing. Contact Pointr support. |
Something went wrong in the wall extraction state! | Wall extraction step failed. Contact Pointr support. |
Something went wrong in the furniture post-process state! | Furniture post process step failed. Contact Pointr support. |
Something went wrong in exporting geojson state! | MapScale service failed to generate the final GeoJSON. Make sure that the CAD file contains a supported type of building. For information on supported building types see here |
Something went wrong in the computing coverage state! | MapScale service failed to calculate the area, unit and furniture coverage percentages. Contact Pointr support. |
Geotransform API did not return any data! | Geotransformer service, which enables georeferencing of the output map, did not return a valid response. Check the validity of the georeferencing anchor points. |
Multiple page PDF files are not supported. | MapScale service does not support multiple page PDF files. In order to process multiple pages, create a separate PDF file for each page. |
Number of elements in the PDF file exceeds the limit. | A typical PDF floor plan contains 10K-100K entities. If a PDF file that contains more than 300K entities, MapScale service returns this message indicating there is something odd with the PDF file. Check the PDF file and delete unnecessary entities. |