Add some documentation about special area linking case

vesameskanen · vesameskanen · commit eb240fff53ea · 2025-04-05T11:06:23.000+03:00
diff --git a/application/src/main/java/org/opentripplanner/routing/linking/VertexLinker.java b/application/src/main/java/org/opentripplanner/routing/linking/VertexLinker.java
@@ -656,6 +656,9 @@ private boolean addAreaVertex(
           )
           .findFirst();
         if (!nearest.isPresent()) {
+          /* This can happen when all (probably the single one) visibility points are very close
+	       to the linked vertex. Such situatin can arise in boarding location linking which skips
+	       the snapping logic of normal linking and calls addPermanentAreaVertex directly */
           nearest = areaGroup.visibilityVertices().stream().findFirst();
         }
         if (nearest.isPresent()) {

Original file line number	Diff line number	Diff line change
`@@ -656,6 +656,9 @@ private boolean addAreaVertex(`
`656`	`656`	`)`
`657`	`657`	`.findFirst();`
`658`	`658`	`if (!nearest.isPresent()) {`
	`659`	`+ /* This can happen when all (probably the single one) visibility points are very close`
	`660`	`+ to the linked vertex. Such situatin can arise in boarding location linking which skips`
	`661`	`+ the snapping logic of normal linking and calls addPermanentAreaVertex directly */`
`659`	`662`	`nearest = areaGroup.visibilityVertices().stream().findFirst();`
`660`	`663`	`}`
`661`	`664`	`if (nearest.isPresent()) {`