Floor Plan jobs allow you to submit images of builder's floor plans, or even rough sketches of floor plans, and have them converted into readable, presentable versions for use in your real estate listings.
https://www.boxbrownie.com/api/v2/job/createFloorPlan
POST
Yes
xml
(string) responseFormat [json|xml]
To create a Floor Plan job, we require you to send us an XML payload that contains a job title and one or more <fileGroup>
blocks that describe the file URL of the image to be edited, and any desired options. You will also need to provide either a <standardTemplate>
value or an <agencyTemplate>
value.
Your job XML should start with a job title.
<jobTitle> | String | Required | Max 1 Occurence | The title for the job. 100 characters max |
---|
Then, for each primary image that you want to include for editing, your XML should include an occurence of <fileGroup>
. A file group will contain all the information for the edit that is being performed. Your XML may contain any number of <fileGroup>
elements.
<fileGroup> | Required | Multiple Allowed | Represents one output. Contains XML for any images (primary and reference images) and any edit options for the output |
|
---|---|---|---|---|
<fileGroupComment> | String | Optional | Max 1 Occurence | An optional comment containing any special instructions for the file group |
Within the <fileGroup>
element, you will need to specify the file URL of the image that is going to be edited. You can specify more than one file URL if desired. The first file URL in each <files>
block is treated as the primary image (the one that will be edited). Any subsequent <fileURL>
elements will be treated as reference images for the edit. You may include any number of <fileURL>
elements, just keep in mind that only the first in each file group will be edited.
<files> | Required | Max 1 Occurence | Contains one or more <fileURL> elements for the file group |
|
---|---|---|---|---|
<fileURL> | String | Required | Multiple Allowed | A file URL. The first occurence of <fileURL> in each <files> block is treated as the primary image for the file group (the one that will be edited). Subsequent <fileURL> elements are treated as reference images only and will not be edited |
Within the <fileGroup>
element, you may optionally provide a <sampleImages>
block that contains one or more <sampleImageId>
elements. This can be used to attach pre-uploaded sample images from your BoxBrownie.com account as additional reference images in the job. For more information, see the Sample Images documentation.
<sampleImages> | Optional | Max 1 Occurence | Contains one or more <sampleImageId> elements for the file group |
|
---|---|---|---|---|
<sampleImageId> | String | Required | Multiple Allowed | The unique ID of a sample image from your BoxBrownie.com account. |
Within the <fileGroup>
element, you will need to define a <template>
block that contains either a <standardTemplate>
value or an <agencyTemplate>
value. Each <fileGroup>
may only contain one of these. The chosen template will determine what options are required/supported in the <options>
block. Please see the section below for more information on which template values are valid.
<template> | String | Required | Max 1 Occurence | Contains either a <standardTemplate> or <agencyTemplate> |
---|---|---|---|---|
<standardTemplate> | String | Optional | Max 1 Occurence | Contains a template identifier for a standard BoxBrownie.com template |
<agencyTemplate> | String | Optional | Max 1 Occurence | Contains a template identifier for an agency-specific template |
Within the <fileGroup>
element, you will need to specify an <options>
block that contains sets of <option>
blocks. Each <option>
block must contain an <optionName>
element and an <optionValue>
block defining the floor plan options that are to be applied.
<options> | Required | Max 1 Occurence | Contains one or more <option> elements for the file group |
|
---|---|---|---|---|
<option> | Required | Multiple Allowed | Contains exactly one <optionName> and one <optionValue> . |
|
<optionName> | String | Required | Max 1 Occurrence | The key of a Floor Plan Option |
<optionValue> | String | Required | Max 1 Occurrence | The key of a Floor Plan Option Value |
Below, you can see an example XML payload. This example defines 2 <fileGroup>
elements, one using a standard template and the other using an agency template. If this were a real job, you could expect to receive 2 completed output floor plans when completed.
<job>
<jobTitle>My Floor Plan</jobTitle>
<fileGroup>
<files>
<fileURL>https://d1dbtne32ilur4.cloudfront.net/img/press/featured02.png</fileURL>
<fileURL>https://d1dbtne32ilur4.cloudfront.net/img/press/featured06.png</fileURL>
</files>
<sampleImages>
<sampleImageId>99ccd87633acb90545c7ebcf4f57511df8d50a33</sampleImageId>
<sampleImageId>d9c2ca823cf01a54df60f190da405151eab3c700</sampleImageId>
</sampleImages>
<template>
<standardTemplate>FLOOR_PLAN_2D_BLACK_WHITE</standardTemplate>
</template>
<options>
<option>
<optionName>2D_BLACK_WHITE_FLOOR_PLAN</optionName>
<optionValue>RESIDENTIAL_2D_BLACK_WHITE_TEXTURED</optionValue>
</option>
<option>
<optionName>PAGE_ORIENTATION</optionName>
<optionValue>ORIENTATION_LANDSCAPE</optionValue>
</option>
<option>
<optionName>PLAN_ORIENTATION</optionName>
<optionValue>ORIENTATION_PORTRAIT</optionValue>
</option>
<option>
<optionName>FLOOR_PLAN_DIMENSIONS</optionName>
<optionValue>DIMENSION_SQ_M</optionValue>
</option>
<option>
<optionName>FILE_TYPE</optionName>
<optionValue>FILE_TYPE_PDF</optionValue>
</option>
<option>
<optionName>INCLUDE_FURNITURE</optionName>
<optionValue>OPTION_NO</optionValue>
</option>
<option>
<optionName>INCLUDE_AGENCY_LOGO</optionName>
<optionValue>OPTION_YES</optionValue>
</option>
<option>
<optionName>DISPLAY_NORTH</optionName>
<optionValue>AS_MARKED_ON_PLAN</optionValue>
</option>
<option>
<optionName>DISCLAIMER_ACCURACY_MEASUREMENT</optionName>
<optionValue>OPTION_YES</optionValue>
</option>
<option>
<optionName>DISPLAY_ADDRESS</optionName>
<optionValue>123 Fake St, Mooloolaba QLD 4558</optionValue>
</option>
</options>
<fileGroupComment>Here is a comment on this floor plan</fileGroupComment>
</fileGroup>
<fileGroup>
<files>
<fileURL>https://d1dbtne32ilur4.cloudfront.net/img/press/featured03.png</fileURL>
<fileURL>https://d1dbtne32ilur4.cloudfront.net/img/press/featured04.png</fileURL>
</files>
<template>
<agencyTemplate>e94df43dc9ef755b1a3f6ba50f825fa92ec2cccf</agencyTemplate>
</template>
<options>
<option>
<optionName>PAGE_ORIENTATION</optionName>
<optionValue>ORIENTATION_LANDSCAPE</optionValue>
</option>
<option>
<optionName>PLAN_ORIENTATION</optionName>
<optionValue>ORIENTATION_PORTRAIT</optionValue>
</option>
<option>
<optionName>FLOOR_PLAN_DIMENSIONS</optionName>
<optionValue>DIMENSION_SQ_M</optionValue>
</option>
<option>
<optionName>FILE_TYPE</optionName>
<optionValue>FILE_TYPE_PDF</optionValue>
</option>
<option>
<optionName>INCLUDE_FURNITURE</optionName>
<optionValue>OPTION_NO</optionValue>
</option>
<option>
<optionName>DISPLAY_NORTH</optionName>
<optionValue>AS_MARKED_ON_PLAN</optionValue>
</option>
<option>
<optionName>DISCLAIMER_ACCURACY_MEASUREMENT</optionName>
<optionValue>OPTION_YES</optionValue>
</option>
<option>
<optionName>DISPLAY_ADDRESS</optionName>
<optionValue>123 Fake St, Mooloolaba QLD 4558</optionValue>
</option>
</options>
<fileGroupComment>Here is a comment on this agency templated floor plan</fileGroupComment>
</fileGroup>
</job>
Below, you can see an example response for the above example API Request.
https://www.boxbrownie.com/api/v2/job/simulateFloorPlan
POST
Yes
xml
(string) responseFormat [json|xml]
The BoxBrownie.com API allows you to simulate the creation of a Floor Plan job in order to check for any errors in the XML payload of a job submission by using this endpoint. Additionally, this endpoint will return the expected job credit cost for the XML payload.
This endpoint accepts the same XML that you would use with the Create a Floor Plan Job endpoint.
Note: Using this endpoint will not create any jobs in your account, and will not charge your BoxBrownie.com account.
Note: Estimated credit cost does not take into account any free trials associated with your BoxBrownie.com account.
Below, you can see an example response when supplying job XML to this endpoint.
https://www.boxbrownie.com/api/v2/job/{jobReference}
GET
Yes
jobReference
(string) responseFormat [json|xml]
You may retrieve details about any job in your BoxBrownie.com account by supplying the reference number of the job jobReference
.
https://www.boxbrownie.com/api/v2/job/reworkFloorPlan
POST
Yes
xml
(string) responseFormat [json|xml]
After a Floor Plan job has been completed, you will have the ability to submit rework requests for any number of completed output images. Similarly to creating a new job, you will be required to supply an XML payload describing which images to rework, with instructions about what you want changed.
You must supply either a <jobId>
or a <jobReference>
and at least one <rework>
block that contains both one <fileId>
and one <reworkComment>
Images are supplied in the form of a <fileId>
, which can be obtained when retrieving a completed job.
Note: Floor Plan jobs can only be reworked if it has been less than 2 months since the jobDateCompleted
time, and if there are no existing active reworks for any supplied <fileId>
values.
Below, you can see an example XML payload. In this example, we are requesting 1 rework for the supplied jobId
.
<job>
<jobId>130fe17ee35d8e0444d18aeed9265555ede53050</jobId>
<rework>
<fileId>75eebcbab044b3fe3358392b56d92b8c6fd6d208</fileId>
<reworkComment>Please add more clouds in the sky</reworkComment>
</rework>
</job>
https://www.boxbrownie.com/api/v2/job/floorPlanStandardTemplate
https://www.boxbrownie.com/api/v2/job/floorPlanStandardTemplate/{standardTemplate}
https://www.boxbrownie.com/api/v2/job/floorPlanStandardTemplate/{standardTemplate}/{optionName}
GET
No
(string) standardTemplate
, (string) optionName
, (string) responseFormat [json|xml]
When creating a new Floor Plan job, you will supply either a <standardTemplate>
value or an <agencyTemplate>
value, as well as some <option>
blocks containing pairs of <optionName>
and <optionValue>
to tell us how you would like your floor plan to be created.
You can query this endpoint to return a list of all accepted <standardTemplate>
values and their accepted floor plan options/values. Alternatively, you can provide the optional standardTemplate
parameter to return only information and accepted values for that specific standard template>
Below is a table of accepted <standardTemplate>
keys. Click on a <standardTemplate>
to see a table of accepted <optionName>
keys for that item.
Note: If an edit type is not clickable in the below table, then it does not have any child options, so an <options>
block is not required for that edit type.
Template Key | Template Description |
FLOOR_PLAN_2D_BLACK_WHITE | Floor Plan Only - 2D Black & White |
---|---|
FLOOR_PLAN_2D_COLOUR | Floor Plan Only - 2D Full Colour |
FLOOR_PLAN_2D_COLOUR_TEXTURED | Floor Plan Only - 2D Colour Textured |
FLOOR_PLAN_3D_COLOUR_ONE_STOREY | Floor Plan Only - 3D Full Colour - Single Storey |
FLOOR_PLAN_3D_COLOUR_TWO_STOREY | Floor Plan Only - 3D Full Colour - Two Storeys |
FLOOR_PLAN_3D_COLOUR_THREE_STOREY | Floor Plan Only - 3D Full Colour - Three Storeys |
COMBO_2D_BLACK_WHITE | Floor & Site Plan Combo - 2D Black & White |
COMBO_2D_COLOUR | Floor & Site Plan Combo - 2D Full Colour |
COMBO_2D_COLOUR_TEXTURED | Site & Floor Plan Combo - 2D Textured |
FLOOR_PLAN_3D_TAILORED_ONE_STOREY | Floor Plan Only - 3D Tailored - Single Storey |
FLOOR_PLAN_3D_TAILORED_TWO_STOREY | Floor Plan Only - 3D Tailored - Two Storeys |
https://www.boxbrownie.com/api/v2/job/floorPlanAgencyTemplate/{agencyId}
https://www.boxbrownie.com/api/v2/job/floorPlanAgencyTemplate/{agencyId}/{agencyTemplate}
https://www.boxbrownie.com/api/v2/job/floorPlanAgencyTemplate/{agencyId}/{agencyTemplate}/{optionName}
GET
No
(string) agencyId
(string) agencyTemplate
, (string) optionName
, (string) responseFormat [json|xml]
When creating a new Floor Plan job, you will supply either a <standardTemplate>
value or an <agencyTemplate>
value, as well as some <option>
blocks containing pairs of <optionName>
and <optionValue>
to tell us how you would like your floor plan to be created.
You can query this endpoint to return a list of all accepted <agencyTemplate>
values and their accepted floor plan options/values, for a given <agencyId>
.
Note: View the Agency Documentation for information on how to obtain <agencyId>
values.