Community and Lot Locations

See your lots on a map, find the ones nearest you in the field, and record where walks happen — by pinning communities and lots.

Overview

Pinning your lots on the map is what switches TPTM's location features on. Once a lot has a pin, you can see the whole community laid out geographically, see what's around you while you're in the field, and have your walkthroughs verified as genuinely on-site.

A location is a pair of map coordinates — a latitude and a longitude — marking exactly where a community or a house sits. Locations are optional, but the features below only work for communities and lots that have one.

Where Locations Are Used

The community map

This is the big one. On a community's lots list, use the List / Map toggle above the table to see every active, pinned lot laid out as it actually sits on the ground.

  • Hover a pin (or tap it on a phone or tablet) to open a card with the lot name, address, status tags, last walk date, project manager, and current stage — enough to triage a lot without leaving the map.

  • Click the card to jump straight to that lot's detail page.

  • With several lots pinned, the map automatically zooms to fit them all.

If some lots aren't pinned yet, a notice tells you how many are missing — for example, "3 lots have no location yet, so they are not on the map." It's informational; those lots are still in the List view.

Nearby lots in the field

The Nearby lots card on Field View shows the pinned lots within 1,000 feet of where you're standing, closest first.

  1. Click Show lots near me.

  2. Allow location access when your browser asks.

  3. The three closest lots appear with their distances. Click the Show more button — it names how many are left — to see the rest.

  4. Click Show map to see them plotted, along with a dot for your own position.

This card isn't limited to your own lots — any active, pinned lot in range appears, with your own listed first and everyone else's labelled with the responsible project manager (or Unassigned). Distances show in feet when you're within about a tenth of a mile, and in miles beyond that.

ℹ️ Note: "No lots within 1,000 feet of you" means lots are pinned but none are close by. "No lots with a location yet" means nothing has been pinned at all — that's the one you fix by setting locations.

On a lot's page

A Location card shows the lot's pin on a read-only map, with the exact coordinates printed next to the heading. The card is simply absent when the lot has no pin — there's no prompt to add one, so set it from the editor.

On a community's page

A Location section shows the community's pin on a read-only map. As with lots, the section doesn't appear at all when the community has no coordinates.

ℹ️ Tip: Read-only maps offer a Show my location button. Click it to drop a dot for your own position alongside the pin — handy for judging whether a pin is placed correctly while you're on site.

How Locations Affect Walks

This is where an accurate pin matters most. A lot's pin is what TPTM measures against to confirm that a walkthrough really happened on site.

⚠️ Important: An automatic walkthrough only records when your device is within 100 feet of the lot's pin. A mis-placed pin can therefore block the automatic walk for a lot you're standing on.

What happens when a walkthrough is recorded depends on the pin and on your device's location:

Situation

Result

Lot is pinned, you're within 100 ft

Recorded as a verified on-site walk, with the measured distance.

Lot is pinned, you're more than 100 ft away

The automatic walk is blocked. The Lot walk tile shows how far off you are and offers a Walk anyway cue, which opens the walk history so you can confirm the walk off-site.

Lot is pinned, your location couldn't be read

The walk records, with a warning that it couldn't be confirmed on-site. Walk again retries.

Lot has no pin

Nothing to measure against, so the check is skipped — the walk records but can never be verified on-site.

You can always record a walk manually from ToolsMark lot as walked, no matter how far away you are. That path never blocks — it just tells you up front whether the walk will be logged as on-site or off-site.

ℹ️ Privacy: Location access is used only to measure your distance from the lot's pin and to stamp the walk record. Raw coordinates are never shared with or displayed to other users.

For the full walkthrough rules, see Lot Walkthroughs.

How to Set a Lot's Location

Lot pins are what power the community map, nearby lots, and on-site walk verification, so this is where most of the value is. Accuracy matters — place the pin on the house, not the street.

  1. Open the lot's detail page and click Edit, or click Create to add a new lot.

  2. Find the Location field, just below Street address.

  3. Place the pin:

    • Click the map on the lot, or drag the pin to fine-tune it.

    • Type the Latitude and Longitude.

    • Paste a lat, lng pair into either box — TPTM splits it and fills in both.

    • Click Use my location — the most accurate option when you're standing on the lot.

  4. Click Save.

Two things on this map help you place the pin accurately:

  • Teal circles mark other lots in the community that are already placed, so you can see how your new pin lines up with its neighbors.

  • If you've already allowed location access in your browser, a dot shows where you currently are.

The map opens centered on the community's location if it has one. If it doesn't, TPTM centers on the lots already placed in that community. If neither exists, you'll start from a zoomed-out national view and have to find the site yourself — which is the main reason to pin the community too.

To remove a location, click Clear location and save.

How to Set a Community's Location

The community pin marks the neighborhood as a whole, and it decides where the map opens when you go to pin the lots inside it — so setting it first makes every lot faster.

  1. Open the community's detail page.

  2. Click Edit in the header.

  3. Scroll to the Location section, below the address fields.

  4. Set the pin using whichever method is easiest:

    • Click the map where the community sits.

    • Type the numbers into the Latitude and Longitude boxes.

    • Paste a coordinate pair like 39.7392, -104.9903 into either box.

    • Click Use my location to drop the pin where you're standing.

  5. Click Save.

To remove a location, click Clear location and save. The button only appears once at least one coordinate has a value.

ℹ️ Tip: The editor map opens centered on the state in the community's address. If the state is blank, you'll get a zoomed-out view of the whole country instead — fill in the address first and the map will land much closer to where you need it.

Both Coordinates or Neither

A location is all-or-nothing. If you fill in a latitude but leave the longitude empty (or the reverse), TPTM won't save the record — you'll see "Enter both latitude and longitude, or clear both."

The lot editor flags this as soon as you leave one box empty. The community editor only flags it after you click Save, so if a community save seems to do nothing, check the Location section for a missing coordinate.

ℹ️ Note: Lots do not inherit the community's coordinates. The community pin only decides where the editor map opens — every lot has to be pinned individually.

What Happens Without a Location

Nothing breaks — the features simply go quiet. Here's the full picture:

If this has no location…

…then

A lot

No Location card on its detail page; missing from the community map (and counted in the "no location yet" notice); never appears in Nearby lots; walkthroughs record without the on-site check, so they can never be verified on-site

A community

No Location section on its detail page; the community map falls back to lot pins; lot editors open on a zoomed-out map

Archived lots are left off the community map and out of Nearby lots even if they still have coordinates.

Locations Are Not Addresses

A location (the map pin) and an address (street, city, state, ZIP) are two separate pieces of information that TPTM stores and edits independently.

Location

Address

What it is

Latitude and longitude coordinates

Street, city, state, ZIP

Used for

Map pins, nearby lots, on-site walk verification

Get directions links, mailing, printed reports

Where you set it

The Location section of the community or lot editor

The address fields in the same editor

⚠️ Important: TPTM does not convert between the two. Typing a street address never creates a pin, and dropping a pin never fills in an address. If you want both, you have to enter both.

This matters most for the Get directions link on a lot, which is built from the lot's address, not its pin. A lot with a perfect pin but a blank address will produce a vague map link.

On lots, city, state, and ZIP are copied down from the community's address automatically, so the only address field you fill in per lot is the street.

ℹ️ Note: Don't confuse any of this with Settings → Locations, which is an unrelated feature for labeling where a task happens (for example, "Garage" or "Master Bath"). Those have nothing to do with maps or coordinates.

Who Can Edit Locations

Action

Permission needed

Set, change, or clear a lot location

Lot update (or Lot create for a new lot)

Set, change, or clear a community location

Community update (or Community create for a new community)

View lot maps, community pins, and nearby lots

Lot read

View community maps and location cards

Community read

If you don't see an Edit button on a community or lot, you don't have the permission to change its location. Contact your administrator.

See Also

  • Lot Walkthroughs — the on-site requirement, off-site walks, and the walk status indicator

  • Community Details — the community page, its statistics, and the lots table

  • Lot Details — everything on a lot's page, including its address and directions link

  • Field View — the field dashboard that hosts Nearby lots

FAQ