github.com/StackExchange/dnscontrol/v4@v4.11.0/documentation/language-reference/domain-modifiers/LOC_BUILDER_DMS_STR.md (about)

     1  ---
     2  name: LOC_BUILDER_DMS_STR
     3  parameters:
     4    - label
     5    - str
     6    - alt
     7    - ttl
     8  parameters_object: true
     9  parameter_types:
    10    label: string?
    11    str: string
    12    alt: number?
    13    ttl: Duration?
    14  ---
    15  
    16  `LOC_BUILDER_DMS_STR({})` actually takes an object with the following properties:
    17  
    18    - label (string, optional, defaults to `@`)
    19    - str (string)
    20    - alt (float32, optional)
    21    - ttl (optional)
    22  
    23  A helper to build [`LOC`](LOC.md) records. Supply three parameters instead of 12.
    24  
    25  Internally assumes some defaults for [`LOC`](LOC.md) records.
    26  
    27  
    28  Accepts a string with degrees, minutes, and seconds (DMS) coordinates in the form: 41°24'12.2"N 2°10'26.5"E
    29  
    30  Note that the following are acceptable forms (symbols differ):
    31  * `33°51′31″S 151°12′51″E`
    32  * `33°51'31"S 151°12'51"E`
    33  * `33d51m31sS 151d12m51sE`
    34  * `33d51m31s S 151d12m51s E`
    35  
    36  {% code title="dnsconfig.js" %}
    37  ```javascript
    38  D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
    39    LOC_BUILDER_DMS_STR({
    40      label: "sydney-opera-house",
    41      str: "33°51′31″S 151°12′51″E",
    42      alt: 4,
    43      ttl: "5m",
    44    }),
    45  END);
    46  ```
    47  {% endcode %}
    48  
    49  
    50  Part of the series:
    51   * [`LOC()`](LOC.md) - build a `LOC` by supplying all 12 parameters
    52   * [`LOC_BUILDER_DD({})`](LOC_BUILDER_DD.md) - accepts cartesian x, y
    53   * [`LOC_BUILDER_DMS_STR({})`](LOC_BUILDER_DMS_STR.md) - accepts DMS 33°51′31″S 151°12′51″E
    54   * [`LOC_BUILDER_DMM_STR({})`](LOC_BUILDER_DMM_STR.md) - accepts DMM 25.24°S 153.15°E
    55   * [`LOC_BUILDER_STR({})`](LOC_BUILDER_STR.md) - tries the coordinate string in all `LOC_BUILDER_DM*_STR()` functions until one works