Merge(APolyline: TTMSFNCMapsPolyline)
Merge(ACoordinates: TTMSFNCMapsCoordinateRecArray)

Merging polylines is essential when you need to combine multiple segments into a single polyline. The Merge function allows you to merge the original polyline with another polyline or an array of coordinates. When you call Merge(APolyline), the provided polyline is added after the last coordinate of the original polyline. Alternatively, Merge(ACoordinates) merges the polyline with the specified coordinate array.

A black polyline displays the route between Chicago and Detroit. A green polyline displays the route between Detroit and Toronto.

After merging both polylines, the blue polyline displays the route from Chicago to Toronto passing through Detroit.

FindNearestPolylineCoordinate(ACoordinate: TTMSFNCMapsCoordinateRec; AMaxDistance: Double; var APolylineIndex: Integer; var ACoordinateIndex: Integer; var ACoordinateRec: TTMSFNCMapsCoordinateRec): Boolean

Sometimes, you need to find the nearest coordinate within a collection of polylines. The FindNearestPolylineCoordinate function does precisely that. You provide a coordinate, and the function searches for the nearest coordinate in the polylines collection. If a coordinate is found within the specified maximum distance (in meters), the function returns True. Additionally, it provides information about the polyline index, coordinate index, and the actual coordinate itself.

In the examples above this method was used to select the desired locations on the polyline. When a click occurs on the polyline, the OnPolyElementClick is triggered. The exact coordinate clicked is retrieved from the AEventData.Coordinate parameter. However, you want to know which coordinate in the polyline's coordinate array corresponds to the clicked point. This is where the FindNearestPolylineCoordinate call comes in. By using this function you can precisely determine the relevant coordinate within the polyline.

procedure TForm1.TMSFNCGoogleMaps1PolyElementClick(Sender: TObject;
  AEventData: TTMSFNCMapsEventData);
var
  c: TTMSFNCMapsCoordinateRec;
  m: TTMSFNCMapsMarker;
  PolylineIndex, CoordinateIndex: Integer;
begin
  TMSFNCMaps1.FindNearestPolylineCoordinate(AEventData.Coordinate.ToRec, -1, PolylineIndex, CoordinateIndex, c);
  m := TMSFNCGoogleMaps1.AddMarker(c);
  m.DefaultIcon.Enabled := True;
end;

When working with TMS FNC Maps, you’ll find a wealth of common helper functions that simplify your development tasks. These functions provide essential utilities and streamline various operations.. Like MeasureDistance for example, to measure the distance between two coordinates.
Explore the TMS FNC Maps online documentation to unlock their full potential.

These polyline helper functions simplify common tasks when working with polylines, making your mapping applications more efficient and user-friendly. Incorporate them into your projects to enhance your mapping experience!