transfer.go

package gtfs

import (
	"strconv"
)

// Transfert.TransferType possible values:
const (
	// 0 or (empty) - This is a recommended transfer point between two routes.
	TransferRecommended = iota

	// 1 - This is a timed transfer point between two routes. The departing vehicle is expected to wait for the arriving one,
	// with sufficient time for a passenger to transfer between routes
	TransferDepartingWaitsForArriving

	// 2 - This transfer requires a minimum amount of time between arrival and departure to ensure a connection.
	// The time required to transfer is specified by min_transfer_time.
	TransferRequiresMinTransferTime

	// 3 - Transfers are not possible between routes at this location.
	TransferImpossible
)

// transfers.txt
// The transfers file is optional. Trip planners normally calculate transfer points based on the relative proximity of stops in
// each route. For potentially ambiguous stop pairs, or transfers where you want to specify a particular choice, use transfers.txt
// to define additional rules for making connections between routes.
type Transfer struct {
	// from_stop_id - Required. The from_stop_id field contains a stop ID that identifies a stop or station where a connection
	// between routes begins. Stop IDs are referenced from the stops.txt file. If the stop ID refers to a station that contains
	// multiple stops, this transfer rule applies to all stops in that station.
	FromStopId string

	// to_stop_id - Required. The to_stop_id field contains a stop ID that identifies a stop or station where a connection between
	// routes ends. Stop IDs are referenced from the stops.txt file. If the stop ID refers to a station that contains multiple stops,
	// this transfer rule applies to all stops in that station.
	ToStopId string

	// transfer_type - Required. The transfer_type field specifies the type of connection for the specified (from_stop_id, to_stop_id)
	// pair. Valid values for this field are:
	// 		0 or (empty) - This is a recommended transfer point between two routes.
	//  	1 - This is a timed transfer point between two routes. The departing vehicle is expected to wait for the arriving one,
	// 			with sufficient time for a passenger to transfer between routes
	//  	2 - This transfer requires a minimum amount of time between arrival and departure to ensure a connection. The time required
	// 			to transfer is specified by min_transfer_time.
	//  	3 - Transfers are not possible between routes at this location.
	// See Transfer constants
	TransferType byte

	// min_transfer_time - Optional. When a connection between routes requires an amount of time between arrival and departure
	// (transfer_type=2), the min_transfer_time field defines the amount of time that must be available in an itinerary to permit a
	// transfer between routes at these stops. The min_transfer_time must be sufficient to permit a typical rider to move between
	// the two stops, including buffer time to allow for schedule variance on each route.
	// The min_transfer_time value must be entered in seconds, and must be a non-negative integer.
	MinTransferTime int

	feed *Feed
}

func (t *Transfer) setField(fieldName, val string) {
	// log.Println("setField", fieldName, value)
	switch fieldName {
	case "from_stop_id":
		t.FromStopId = val
		break
	case "to_stop_id":
		t.ToStopId = val
		break
	case "route_long_name":
		v, _ := strconv.Atoi(val) // Should panic on error !
		t.MinTransferTime = v
		break
	case "route_type":
		v, _ := strconv.Atoi(val) // Should panic on error !
		if v == 0 {
			t.TransferType = TransferRecommended
		} else if v == 1 {
			t.TransferType = TransferDepartingWaitsForArriving
		} else if v == 2 {
			t.TransferType = TransferRequiresMinTransferTime
		} else if v == 3 {
			t.TransferType = TransferImpossible
		}
		break
	}
}