Method:
DataTools.Enhance.Address.Geocoding.Gnaf.Au.Append
WARNING: THIS METHOD HAS BEEN DISCONTINUED
Use to geocode Australian addresses with the G-NAF dataset
Test:
Input Parameters:
Output Fields:
| Field | Description |
| Longitude | Longitude |
| Latitude | Latitude |
| GeocodeResultLevel | Returns a code that indicates the level to which the address could be geocoded. [Option Values] |
| GeocodeResultLevelDescription | A meaningful description of the level to which the address could be geocoded. |
| GnafSa1-2011 | An 11-digit SA1 2011 code that is fully hierarchical and comprises of the S/T identifier, SA4 identifier, SA3 identifier, SA2 identifier and a SA1 identifier. |
| GnafSa1b-2011 | A 7-digit SA1 2011 code is not fully hierarchical and comprises of the S/T identifier, SA2 identifier and SA1 identifier. |
| GnafSa1-2016 | An 11-digit SA1 2016 code that is fully hierarchical and comprises of the S/T identifier, SA4 identifier, SA3 identifier, SA2 identifier and a SA1 identifier. |
| GnafSa1b-2016 | A 7-digit SA1 2016 code is not fully hierarchical and comprises of the S/T identifier, SA2 identifier and SA1 identifier. |
| GnafSa1-2021 | An 11-digit SA1 2021 code that is fully hierarchical and comprises of the S/T identifier, SA4 identifier, SA3 identifier, SA2 identifier and a SA1 identifier. |
| GnafSa1b-2021 | A 7-digit SA1 2021 code is not fully hierarchical and comprises of the S/T identifier, SA2 identifier and SA1 identifier. |
| LGA-2011 | Local Government Area 2011 code. |
| LGA-2016 | Local Government Area 2016 code. |
| LGA-2020 | Local Government Area 2020 code. |
| LGA-2021 | Local Government Area 2021 code. |
| MechBlock-2011 | 2011 Mesh Block code. The smallest geographical area defined by the ABS. |
| MechBlock-2016 | 2016 Mesh Block code. The smallest geographical area defined by the ABS. |
| MeshBlock-2021 | 2021 Mesh Block code. The smallest geographical area defined by the ABS. |
| GnafPid | The G-NAF Persistent Identifier (G-NAF PID) is a 9-digit number that uniquely identifies each G-NAF address. |
Supported Web Service API Interfaces:
Web Service Method: ProcessQueryStringRequest (REST)
Request Format: Url QueryString,
Protocols: HTTP GET, HTTPS GET,
Response Formats: JSON, XML*
Example Server Path: https://customname.datatoolscloud.net.au/KleberWebService/DtKleberService.svc
Sample QueryString Request:
/ProcessQueryStringRequest?Method=DataTools.Enhance.Address.Geocoding.Gnaf.Au.Append&AddressLine1=&AddressLine2=&AddressLine3=&AddressLine4=&AddressLine5=&AddressLine6=&Locality=&State=&Postcode=&RequestId=&RequestKey=&DepartmentCode=
Sample JSON Response:
{
"DtResponse":{
"RequestId":"",
"ResultCount":"1",
"ErrorMessage":"",
"Result":[
{
"Longitude":"",
"Latitude":"",
"GeocodeResultLevel":"",
"GeocodeResultLevelDescription":"",
"GnafSa1-2011":"",
"GnafSa1b-2011":"",
"GnafSa1-2016":"",
"GnafSa1b-2016":"",
"GnafSa1-2021":"",
"GnafSa1b-2021":"",
"LGA-2011":"",
"LGA-2016":"",
"LGA-2020":"",
"LGA-2021":"",
"MechBlock-2011":"",
"MechBlock-2016":"",
"MeshBlock-2021":"",
"GnafPid":""
}
]
}
}
* Add the additional input parameter "OutputFormat=json" or "OutputFormat=xml" to change the response format from default.
* Add the additional input parameter "callback" to convert JSON responses to JSONP responses for across domains support.
CORS header included where callback is not defined.
Please Note:
Ensure you thoroughly test all the methods you are using and are happy with the results before going into production. DataTools is charged by the data suppliers for use of every method – therefore
ALL calls to any method will incur a COST. When you register DataTools provides you with free credit to help with development and trialling of the service. Once that credit is used you will need to purchase a monthly subscription and/or top up to continue using the service, even for development purposes. Please check the Method Pricing List for all current costs. DataTools does not warrant or guarantee the quality of the results returned and will not be held responsible for any costs incurred by using a method. Should you have any questions please contact your Sales representative or the Client Services team.