This guide explains every step of the Fetch Property Image feature on the property edit page.

Overview

The Fetch Property Image panel is on the Media tab of any property edit page. It lets you capture a Google Street View (or satellite) image of the property and attach it to the listing — without ever leaving the edit form and without needing to save between each attempt.

The panel works alongside two other tools in the same row:

• Pin Map (left) — a Leaflet street map. Drag the red marker or click the map to set the exact latitude/longitude of the property.
• Street View (centre) — a live interactive Google Street View window that updates automatically when you move the pin.
• Fetch Image panel (right) — controls for FOV, camera heading, a live still-image preview, and the final Fetch & Save button.

Step-by-step Workflow

1 — Open the Media tab

Click the Media tab at the top of the property edit form. You will see the three-column Location & Image Capture card at the top of the tab.

2 — Position the pin

The pin map loads at street level (zoom 19) centred on the saved coordinates. Use it to pinpoint the exact location of the property:

• Drag the red marker to the correct spot.
• Or click anywhere on the map to move the marker to that point.
• The Latitude and Longitude fields above the map update automatically — no save needed.
• Use the layer switcher (top-right of the map) to toggle between Street and Satellite views for reference.

3 — Check the Street View preview (centre panel)

The interactive Street View window follows the pin automatically. Click and drag inside it to look around. Use it to confirm that street-level imagery exists near the pin before you try to capture a still image.

If the message "No Street View imagery within 100 m" appears, move the pin closer to the road and the panorama will update.

4 — Adjust FOV (field of view / zoom)

The FOV setting in the Fetch panel controls how zoomed-in or wide the captured image will be:

• 10° – 30° — Telephoto close-up. Good for distant buildings.
• 60° – 80° — Normal view (default 80°).
• 100° – 120° — Wide-angle, more surrounding context.

The Live preview strip at the top of the Fetch panel updates automatically as you change the FOV — no save needed to see the result.

5 — Set camera heading

Heading controls the direction the camera faces in the still capture.

• Auto (default) — the server calculates the best angle from the nearest Street View camera toward the pin. Use this for most properties.
• Manual — uncheck Auto heading, then type a degree value (0 = North, 90 = East, 180 = South, 270 = West) or click one of the compass shortcut buttons (N, NE, E, SE, S, SW, W, NW). Use this when the automatic angle is not ideal.

The Live preview updates when you change the heading so you can confirm the angle before fetching.

6 — Confirm the live preview

The small image strip near the top of the Fetch panel is a live still from the Google Street View Static API. It refreshes automatically (within about one second) whenever you:

• Move the pin on the Leaflet map
• Change the FOV field
• Change heading or toggle Auto / Manual
• Edit the Latitude or Longitude fields directly

Keep adjusting pin position, FOV, and heading until the preview shows exactly the frame you want.

7 — Click "Fetch & Save"

Click the blue Fetch & Save button. The system will:

1. Request a full-resolution image (1280 × 960 px) from Google Street View.
2. Save the file to the property image folder on the server.
3. Attach it to the property image gallery.
4. Show a success notice (FOV used, heading used, source type) and reload the page automatically.

8 — Review and repeat if needed

After the page reloads, scroll down on the Media tab to the image gallery. The fetched image will appear there. If the angle or framing is not right, delete the image (trash icon in the gallery), then return to step 4 and adjust your settings.

Fallback: Satellite image

If no Street View imagery exists within 100 m of the pin, the system automatically falls back to a Google Maps hybrid satellite image. The success notice will show source=satellite. You can move the pin and try again, but satellite is the only option when no street-level photography exists for that location.

Troubleshooting