dnscontrol/documentation/functions/record/LOC_BUILDER_DD.md

name	parameters	parameters_object	parameter_types
LOC_BUILDER_DD	label x y alt ttl	true	label x y alt ttl string? number number number? Duration?

LOC_BUILDER_DD({}) actually takes an object with the following properties:

• label (optional, defaults to @)
• x (float32)
• y (float32)
• alt (float32, optional)
• ttl (optional)

A helper to build LOC records. Supply four parameters instead of 12.

Internally assumes some defaults for LOC records.

The cartesian coordinates are decimal degrees, like you typically find in e.g. Google Maps.

Examples.

Big Ben: 51.50084265331501, -0.12462541415599787

The White House: 38.89775977858357, -77.03655125982903

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

D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
    LOC_BUILDER_DD({
    label: "big-ben",
    x: 51.50084265331501,
    y: -0.12462541415599787,
    alt: 6,
  })
  , LOC_BUILDER_DD({
    label: "white-house",
    x: 38.89775977858357,
    y: -77.03655125982903,
    alt: 19,
  })
  , LOC_BUILDER_DD({
    label: "white-house-ttl",
    x: 38.89775977858357,
    y: -77.03655125982903,
    alt: 19,
    ttl: "5m",
  })
);

{% 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 cooordinate string in all LOC_BUILDER_DM*_STR() functions until one works