> For the complete documentation index, see [llms.txt](https://docs.dnscontrol.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dnscontrol.org/language-reference/domain-modifiers/loc_builder_str.md).

# LOC\_BUILDER\_STR

`LOC_BUILDER_STR({})` actually takes an object with the following: properties.

* label (optional, defaults to `@`)
* str (string)
* alt (float32, optional)
* ttl (optional)

A helper to build [`LOC`](/language-reference/domain-modifiers/loc.md) records. Supply three parameters instead of 12.

Internally assumes some defaults for [`LOC`](/language-reference/domain-modifiers/loc.md) records.

Accepts a string and tries all `LOC_BUILDER_DM*_STR({})` methods:

* [`LOC_BUILDER_DMS_STR({})`](/language-reference/domain-modifiers/loc_builder_dms_str.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](/language-reference/domain-modifiers/loc_builder_dmm_str.md) - accepts DMM 25.24°S 153.15°E

{% code title="dnsconfig.js" %}

```javascript
D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
  LOC_BUILDER_STR({
    label: "old-faithful",
    str: "44.46046°N 110.82815°W",
    alt: 2240,
  }),
  LOC_BUILDER_STR({
    label: "ribblehead-viaduct",
    str: "54.210436°N 2.370231°W",
    alt: 300,
  }),
  LOC_BUILDER_STR({
    label: "guinness-brewery",
    str: "53°20′40″N 6°17′20″W",
    alt: 300,
  }),
);
```

{% endcode %}

Part of the series:

* [`LOC()`](/language-reference/domain-modifiers/loc.md) - build a `LOC` by supplying all 12 parameters
* [`LOC_BUILDER_DD({})`](/language-reference/domain-modifiers/loc_builder_dd.md) - accepts cartesian x, y
* [`LOC_BUILDER_DMS_STR({})`](/language-reference/domain-modifiers/loc_builder_dms_str.md) - accepts DMS 33°51′31″S 151°12′51″E
* [`LOC_BUILDER_DMM_STR({})`](/language-reference/domain-modifiers/loc_builder_dmm_str.md) - accepts DMM 25.24°S 153.15°E
* [`LOC_BUILDER_STR({})`](/language-reference/domain-modifiers/loc_builder_str.md) - tries the coordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works