dnscontrol/documentation/language-reference/domain-modifiers/LOC_BUILDER_STR.md

name	parameters	parameters_object	parameter_types
LOC_BUILDER_STR	label str alt ttl	true	label str alt ttl string? string number? Duration?

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 records. Supply three parameters instead of 12.

Internally assumes some defaults for LOC records.

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

• LOC_BUILDER_DMS_STR({}) - accepts DMS 33°51′31″S 151°12′51″E
• LOC_BUILDER_DMM_STR({}) - accepts DMM 25.24°S 153.15°E

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

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() - build a LOC by supplying all 12 parameters
• LOC_BUILDER_DD({}) - accepts cartesian x, y
• LOC_BUILDER_DMS_STR({}) - accepts DMS 33°51′31″S 151°12′51″E
• LOC_BUILDER_DMM_STR({}) - accepts DMM 25.24°S 153.15°E
• LOC_BUILDER_STR({}) - tries the coordinate string in all LOC_BUILDER_DM*_STR() functions until one works