Skip to content

Main content

Residential Location Nightday Label Tool

Label an explicitly supplied residential-location day/night reference period without inferring home or work locations.

Loading tool…

Description

Label a residential location's recorded day/night reference period.

Geographic activity records depend on location precision, boundary vintage, observation time, population denominator and access-window conventions. A travel-time budget differs from actual accessibility, and rectangular cell area does not establish privacy. Local shares and labels need the original survey and spatial definitions.

Label a residential location's recorded day/night reference period.

When to use this tool

Use Residential Location Nightday Label when you already have locationRecordId, referencePeriod and need to label a residential location's recorded day/night reference period.

How to use the tool and how it works

  1. Enter locationRecordId, referencePeriod. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read label. Use the output convention below.

Require locationRecordId nonempty and referencePeriod night, day, mixed or unknown; format ID [period].1

Input fieldMeaning and unitsAccepted input
locationRecordIdLocation Record IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
referencePeriodReference PeriodRequired. Text; one of "night", "day", "mixed", "unknown"; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
labelLabelRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "locationRecordId": "L17",
    "referencePeriod": "night"
  },
  "output": {
    "label": "L17 [night]"
  }
}

Limitations and assumptions

  • No location, residence, mobility pattern, privacy protection or actual occupancy is inferred.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Use the actual route, service schedule, survey frame and boundary source when assessing mobility or access. Review disclosure across the full spatial dataset and linked records; a location label or cell-size product is not a complete privacy method.

References

  1. Calculation and input contract: human-geography/residential-location-nightday-label — tool.io

Similar or alternative tools