HeatMapApi
| Method | HTTP request |
|---|---|
| getCoverageLonLatHeatMaps | GET coverage/{lon};{lat}/heat_maps |
| getCoverageRegionHeatMaps | GET coverage/{region}/heat_maps |
getCoverageLonLatHeatMaps
Parameters
| Name | Type | Note |
|---|---|---|
| lat | Double | The latitude of where the coord you want to query |
| lon | Double | The longitude of where the coord you want to query |
| from | String | The id of the departure of your journey. If not provided an isochrone is computed. [optional] |
| to | String | The id of the arrival of your journey. If not provided an isochrone is computed. [optional] |
| datetime | DateTime | Date and time to go/arrive (see datetime_represents). Note: the datetime must be in the coverage’s publication period. [optional] |
| datetimeRepresents | String | Determine how datetime is handled. Possible values: * 'departure' - Compute journeys starting after datetime * 'arrival' - Compute journeys arriving before datetime [optional] [default to departure] [enum: arrival, departure] |
| maxNbTransfers | Int | Maximum number of transfers in each journey [optional] |
| minNbTransfers | Int | Minimum number of transfers in each journey [optional] |
| firstSectionMode | List |
Force the first section mode if the first section is not a public transport one. bss stands for bike sharing system. Note 1: It’s an array, you can give multiple modes. Note 2: Choosing bss implicitly allows the walking mode since you might have to walk to the bss station. Note 3: The parameter is inclusive, not exclusive, so if you want to forbid a mode, you need to add all the other modes. Eg: If you never want to use a car, you need: first_section_mode[]=walking&first_section_mode[]=bss&first_section_mode[]=bike&last_section_mode[]=walking&last_section_mode[]=bss&last_section_mode[]=bike [optional] [enum: taxi, walking, car_no_park, car, ridesharing, bss, bike] |
| lastSectionMode | List |
Same as first_section_mode but for the last section. [optional] [enum: taxi, walking, car_no_park, car, ridesharing, bss, bike] |
| maxDurationToPt | Int | Maximum allowed duration to reach the public transport (same limit used before and after public transport). Use this to limit the walking/biking part. Unit is seconds [optional] |
| maxWalkingDurationToPt | Int | Maximal duration of walking on public transport in second [optional] |
| maxBikeDurationToPt | Int | Maximal duration of bike on public transport in second [optional] |
| maxBssDurationToPt | Int | Maximal duration of bss on public transport in second [optional] |
| maxCarDurationToPt | Int | Maximal duration of car on public transport in second [optional] |
| maxRidesharingDurationToPt | Int | Maximal duration of ridesharing on public transport in second [optional] |
| maxCarNoParkDurationToPt | Int | Maximal duration of car no park on public transport in second [optional] |
| maxTaxiDurationToPt | Int | Maximal duration of taxi on public transport in second, only available in distributed scenario [optional] |
| walkingSpeed | Float | Walking speed for the fallback sections. Speed unit must be in meter/second [optional] |
| bikeSpeed | Float | Biking speed for the fallback sections. Speed unit must be in meter/second [optional] |
| bssSpeed | Float | Speed while using a bike from a bike sharing system for the fallback sections. Speed unit must be in meter/second [optional] |
| carSpeed | Float | Driving speed for the fallback sections. Speed unit must be in meter/second [optional] |
| ridesharingSpeed | Float | ridesharing speed for the fallback sections. Speed unit must be in meter/second [optional] |
| carNoParkSpeed | Float | Driving speed without car park for the fallback sections. Speed unit must be in meter/second [optional] |
| taxiSpeed | Float | taxi speed speed for the fallback sections. Speed unit must be in meter/second [optional] |
| forbiddenUris | List |
If you want to avoid lines, modes, networks, etc. Note: the forbidden_uris[] concern only the public transport objects. You can’t for example forbid the use of the bike with them, you have to set the fallback modes for this (first_section_mode[] and last_section_mode[]) [optional] |
| allowedId | List |
If you want to use only a small subset of the public transport objects in your solution. Note: The constraint intersects with forbidden_uris[]. For example, if you ask for allowed_id[]=line:A&forbidden_uris[]=physical_mode:Bus, only vehicles of the line A that are not buses will be used. [optional] |
| disruptionActive | Boolean | DEPRECATED, replaced by data_freshness. If true the algorithm takes the disruptions into account, and thus avoid disrupted public transport. Nota: disruption_active=true <=> data_freshness=realtime [optional] |
| dataFreshness | String | Define the freshness of data to use to compute journeys. When using the following parameter &data_freshness=base_schedule you can get disrupted journeys in the response. You can then display the disruption message to the traveler and make a realtime request to get a new undisrupted solution. Possible values: * 'base_schedule' - Use theoric schedule information * 'adapted_schedule' - Use of adapted schedule information (like strike adjusting, etc.). Prefer realtime for traveler information as it will also contain adapted information schedule. * 'realtime' - Use all realtime information [optional] [enum: base_schedule, adapted_schedule, realtime] |
| maxDuration | Int | Maximum duration of journeys in seconds (from datetime parameter). More usefull when computing an isochrone (only from or to is provided). On a classic journey (from-to), it will mostly speedup Navitia: You may have journeys a bit longer than that value (you would have to filter them). [optional] |
| wheelchair | Boolean | If true the traveler is considered to be using a wheelchair, thus only accessible public transport are used. Be warned: many data are currently too faint to provide acceptable answers with this parameter on. [optional] |
| travelerType | String | Define speeds and accessibility values for different kind of people. Each profile also automatically determines appropriate first and last section modes to the covered area. Note: this means that you might get car, bike, etc. fallback routes even if you set forbidden_uris[]! You can overload all parameters (especially speeds, distances, first and last modes) by setting all of them specifically. We advise that you don’t rely on the traveler_type’s fallback modes (first_section_mode[] and last_section_mode[]) and set them yourself. [optional] [enum: cyclist, luggage, wheelchair, standard, motorist, fast_walker, slow_walker] |
| directPath | String | Specify if direct path should be suggested [optional] [default to indifferent] [enum: indifferent, only, none, only_with_alternatives] |
| freeRadiusFrom | Int | Radius length (in meters) around the coordinates of departure in which the stop points are considered free to go (crowfly=0) [optional] |
| freeRadiusTo | Int | Radius length (in meters) around the coordinates of arrival in which the stop points are considered free to go (crowfly=0) [optional] |
| directPathMode | List |
Force the direct-path modes.If this list is not empty, we only compute direct_path for modes in this listAnd filter all the direct_paths of modes in first_section_mode[] [optional] [enum: taxi, walking, car_no_park, car, ridesharing, bss, bike] |
| partnerServices | List |
Expose only the partner type into the response. [optional] [enum: ridesharing] |
| additionalTimeAfterFirstSectionTaxi | Int | the additional time added to the taxi section, right after riding the taxi but before hopping on the public transit [optional] |
| additionalTimeBeforeLastSectionTaxi | Int | the additional time added to the taxi section, right before riding the taxi but after hopping off the public transit [optional] |
| resolution | Int | Sampling resolution [optional] [default to 500] |
Return
Example
ExpertSdk.getInstance().heatMapApi.getCoverageLonLatHeatMaps(
lat = 0.0,
lon = 0.0,
from = "from_example",
to = "to_example",
datetime = DateTime.now(),
datetimeRepresents = "datetimeRepresents_example",
maxNbTransfers = 123,
minNbTransfers = 123,
firstSectionMode = listOf(),
lastSectionMode = listOf(),
maxDurationToPt = 123,
maxWalkingDurationToPt = 123,
maxBikeDurationToPt = 123,
maxBssDurationToPt = 123,
maxCarDurationToPt = 123,
maxRidesharingDurationToPt = 123,
maxCarNoParkDurationToPt = 123,
maxTaxiDurationToPt = 123,
walkingSpeed = 0f,
bikeSpeed = 0f,
bssSpeed = 0f,
carSpeed = 0f,
ridesharingSpeed = 0f,
carNoParkSpeed = 0f,
taxiSpeed = 0f,
forbiddenUris = listOf(),
allowedId = listOf(),
disruptionActive = true,
dataFreshness = "dataFreshness_example",
maxDuration = 123,
wheelchair = true,
travelerType = "travelerType_example",
directPath = "directPath_example",
freeRadiusFrom = 123,
freeRadiusTo = 123,
directPathMode = listOf(),
partnerServices = listOf(),
additionalTimeAfterFirstSectionTaxi = 123,
additionalTimeBeforeLastSectionTaxi = 123,
resolution = 123
)
if (response.isSuccessful && response.body() != null) {
// Success
val content = response.body()
} else {
// Error
}
getCoverageRegionHeatMaps
Parameters
| Name | Type | Note |
|---|---|---|
| region | String | The region you want to query |
| from | String | The id of the departure of your journey. If not provided an isochrone is computed. [optional] |
| to | String | The id of the arrival of your journey. If not provided an isochrone is computed. [optional] |
| datetime | DateTime | Date and time to go/arrive (see datetime_represents). Note: the datetime must be in the coverage’s publication period. [optional] |
| datetimeRepresents | String | Determine how datetime is handled. Possible values: * 'departure' - Compute journeys starting after datetime * 'arrival' - Compute journeys arriving before datetime [optional] [default to departure] [enum: arrival, departure] |
| maxNbTransfers | Int | Maximum number of transfers in each journey [optional] |
| minNbTransfers | Int | Minimum number of transfers in each journey [optional] |
| firstSectionMode | List |
Force the first section mode if the first section is not a public transport one. bss stands for bike sharing system. Note 1: It’s an array, you can give multiple modes. Note 2: Choosing bss implicitly allows the walking mode since you might have to walk to the bss station. Note 3: The parameter is inclusive, not exclusive, so if you want to forbid a mode, you need to add all the other modes. Eg: If you never want to use a car, you need: first_section_mode[]=walking&first_section_mode[]=bss&first_section_mode[]=bike&last_section_mode[]=walking&last_section_mode[]=bss&last_section_mode[]=bike [optional] [enum: taxi, walking, car_no_park, car, ridesharing, bss, bike] |
| lastSectionMode | List |
Same as first_section_mode but for the last section. [optional] [enum: taxi, walking, car_no_park, car, ridesharing, bss, bike] |
| maxDurationToPt | Int | Maximum allowed duration to reach the public transport (same limit used before and after public transport). Use this to limit the walking/biking part. Unit is seconds [optional] |
| maxWalkingDurationToPt | Int | Maximal duration of walking on public transport in second [optional] |
| maxBikeDurationToPt | Int | Maximal duration of bike on public transport in second [optional] |
| maxBssDurationToPt | Int | Maximal duration of bss on public transport in second [optional] |
| maxCarDurationToPt | Int | Maximal duration of car on public transport in second [optional] |
| maxRidesharingDurationToPt | Int | Maximal duration of ridesharing on public transport in second [optional] |
| maxCarNoParkDurationToPt | Int | Maximal duration of car no park on public transport in second [optional] |
| maxTaxiDurationToPt | Int | Maximal duration of taxi on public transport in second, only available in distributed scenario [optional] |
| walkingSpeed | Float | Walking speed for the fallback sections. Speed unit must be in meter/second [optional] |
| bikeSpeed | Float | Biking speed for the fallback sections. Speed unit must be in meter/second [optional] |
| bssSpeed | Float | Speed while using a bike from a bike sharing system for the fallback sections. Speed unit must be in meter/second [optional] |
| carSpeed | Float | Driving speed for the fallback sections. Speed unit must be in meter/second [optional] |
| ridesharingSpeed | Float | ridesharing speed for the fallback sections. Speed unit must be in meter/second [optional] |
| carNoParkSpeed | Float | Driving speed without car park for the fallback sections. Speed unit must be in meter/second [optional] |
| taxiSpeed | Float | taxi speed speed for the fallback sections. Speed unit must be in meter/second [optional] |
| forbiddenUris | List |
If you want to avoid lines, modes, networks, etc. Note: the forbidden_uris[] concern only the public transport objects. You can’t for example forbid the use of the bike with them, you have to set the fallback modes for this (first_section_mode[] and last_section_mode[]) [optional] |
| allowedId | List |
If you want to use only a small subset of the public transport objects in your solution. Note: The constraint intersects with forbidden_uris[]. For example, if you ask for allowed_id[]=line:A&forbidden_uris[]=physical_mode:Bus, only vehicles of the line A that are not buses will be used. [optional] |
| disruptionActive | Boolean | DEPRECATED, replaced by data_freshness. If true the algorithm takes the disruptions into account, and thus avoid disrupted public transport. Nota: disruption_active=true <=> data_freshness=realtime [optional] |
| dataFreshness | String | Define the freshness of data to use to compute journeys. When using the following parameter &data_freshness=base_schedule you can get disrupted journeys in the response. You can then display the disruption message to the traveler and make a realtime request to get a new undisrupted solution. Possible values: * 'base_schedule' - Use theoric schedule information * 'adapted_schedule' - Use of adapted schedule information (like strike adjusting, etc.). Prefer realtime for traveler information as it will also contain adapted information schedule. * 'realtime' - Use all realtime information [optional] [enum: base_schedule, adapted_schedule, realtime] |
| maxDuration | Int | Maximum duration of journeys in seconds (from datetime parameter). More usefull when computing an isochrone (only from or to is provided). On a classic journey (from-to), it will mostly speedup Navitia: You may have journeys a bit longer than that value (you would have to filter them). [optional] |
| wheelchair | Boolean | If true the traveler is considered to be using a wheelchair, thus only accessible public transport are used. Be warned: many data are currently too faint to provide acceptable answers with this parameter on. [optional] |
| travelerType | String | Define speeds and accessibility values for different kind of people. Each profile also automatically determines appropriate first and last section modes to the covered area. Note: this means that you might get car, bike, etc. fallback routes even if you set forbidden_uris[]! You can overload all parameters (especially speeds, distances, first and last modes) by setting all of them specifically. We advise that you don’t rely on the traveler_type’s fallback modes (first_section_mode[] and last_section_mode[]) and set them yourself. [optional] [enum: cyclist, luggage, wheelchair, standard, motorist, fast_walker, slow_walker] |
| directPath | String | Specify if direct path should be suggested [optional] [default to indifferent] [enum: indifferent, only, none, only_with_alternatives] |
| freeRadiusFrom | Int | Radius length (in meters) around the coordinates of departure in which the stop points are considered free to go (crowfly=0) [optional] |
| freeRadiusTo | Int | Radius length (in meters) around the coordinates of arrival in which the stop points are considered free to go (crowfly=0) [optional] |
| directPathMode | List |
Force the direct-path modes.If this list is not empty, we only compute direct_path for modes in this listAnd filter all the direct_paths of modes in first_section_mode[] [optional] [enum: taxi, walking, car_no_park, car, ridesharing, bss, bike] |
| partnerServices | List |
Expose only the partner type into the response. [optional] [enum: ridesharing] |
| additionalTimeAfterFirstSectionTaxi | Int | the additional time added to the taxi section, right after riding the taxi but before hopping on the public transit [optional] |
| additionalTimeBeforeLastSectionTaxi | Int | the additional time added to the taxi section, right before riding the taxi but after hopping off the public transit [optional] |
| resolution | Int | Sampling resolution [optional] [default to 500] |
Return
Example
ExpertSdk.getInstance().heatMapApi.getCoverageRegionHeatMaps(
region = "region_example",
from = "from_example",
to = "to_example",
datetime = DateTime.now(),
datetimeRepresents = "datetimeRepresents_example",
maxNbTransfers = 123,
minNbTransfers = 123,
firstSectionMode = listOf(),
lastSectionMode = listOf(),
maxDurationToPt = 123,
maxWalkingDurationToPt = 123,
maxBikeDurationToPt = 123,
maxBssDurationToPt = 123,
maxCarDurationToPt = 123,
maxRidesharingDurationToPt = 123,
maxCarNoParkDurationToPt = 123,
maxTaxiDurationToPt = 123,
walkingSpeed = 0f,
bikeSpeed = 0f,
bssSpeed = 0f,
carSpeed = 0f,
ridesharingSpeed = 0f,
carNoParkSpeed = 0f,
taxiSpeed = 0f,
forbiddenUris = listOf(),
allowedId = listOf(),
disruptionActive = true,
dataFreshness = "dataFreshness_example",
maxDuration = 123,
wheelchair = true,
travelerType = "travelerType_example",
directPath = "directPath_example",
freeRadiusFrom = 123,
freeRadiusTo = 123,
directPathMode = listOf(),
partnerServices = listOf(),
additionalTimeAfterFirstSectionTaxi = 123,
additionalTimeBeforeLastSectionTaxi = 123,
resolution = 123
)
if (response.isSuccessful && response.body() != null) {
// Success
val content = response.body()
} else {
// Error
}