Using location autocomplete

When you add or edit a stop, the Address field is a search-as-you-type autocomplete — not a plain text box. Picking from the suggestions matters more than it looks: it's what locks in the exact map coordinates customers will navigate to.

If you free-type an address and skip the suggestions, the pin can end up off by a block, in the wrong building, or even in a different city.

How it works

On the web

• Powered by Mapbox, biased toward West Palm Beach for relevant suggestions.

• Type at least 3 characters. After about a quarter-second, suggestions appear in a dropdown below the field.

• Each suggestion shows the street address with city/state/ZIP underneath.

• Click a suggestion to lock in the address and coordinates.

On iOS

• Powered by Apple Maps (the same MKLocalSearchCompleter used in the Maps app).
• Tap the Address field; suggestions appear as you type.
• Each suggestion shows a title (place name or street) with a subtitle (locality details).
• Tap a suggestion to lock in.

Tips for getting the pin in the right spot

1. Always pick from the dropdown — don't just type and tab away

This is the single most common cause of "my pin is in the wrong place" complaints. The dropdown selection is what gives us exact coordinates. Free text without a selection means we have only a guess.

2. Use the place name, not just the street address, when possible

For well-known spots (parks, shopping centers, breweries, office buildings), search by name first:

• "WPB City Hall" is more accurate than "401 Clematis St".
• "Grandview Public Market" is more accurate than the street address.

Why? Place names hit the exact pin a customer would tap to get directions. Street addresses sometimes resolve to the rooftop center of a building, not the curb you're parked on.

3. If your spot is hidden, search for the nearest landmark

Some food truck spots aren't on any map — back lots, vacant lots, side streets. For those:

• Find the nearest named landmark (the next building over, the cross-street, a nearby business).
• Pick that from the autocomplete.
• Then update the Location name field to your real spot — for example, address autocomplete picks "100 N Olive Ave" but your Location name is "The lot behind the Galleria".

Customers see your Location name prominently and use the address pin to navigate. Both should be useful.

4. Verify the pin before saving

The autocomplete shows you the address, but the pin is what ends up on the customer-facing map. Take a quick mental check after picking — is this the right neighborhood? Is the cross-street right? Save as soon as it looks right.

5. Save your favorites as saved locations

If you set up a stop for a place you'll be at again, the system auto-saves the location. Next time, pick it from the Location dropdown — same coordinates every time, no chance of typos drifting your pin around.

Common questions

No suggestions appear when I type. Check your internet connection. Both Mapbox (web) and Apple Maps (iOS) require online access. If you're on a slow connection, give it a few seconds — suggestions appear after a short debounce.

The address I want isn't in the suggestions. Try fewer characters or a different starting word. If you typed the city first (e.g., "West Palm Beach"), try the street name first instead. If a place is genuinely not on the map, use the nearest-landmark trick from tip 3 above.

I picked an address but the pin is in the wrong spot. Some addresses resolve to a rooftop center rather than the curb. Try searching by place name (tip 2) or by the cross-street and adjust your Location name to clarify for customers. If this happens repeatedly for the same spot, email us — sometimes we can flag the place to use the right pin.

Can I drop a pin manually instead of using the autocomplete? Not today. Manual pin drop is on the roadmap. For now, the autocomplete + Location name combo is the way.

Why is the autocomplete biased to West Palm Beach? We're a WPB-first platform — biasing keeps your everyday searches fast and accurate. If you're setting up a stop outside the area (a festival, a road trip), just type more of the address (city or ZIP) to get suggestions further afield.

Still stuck?

Email info@truckedup.food.