- Print
- DarkLight
- PDF
Operation is used to get a list of poles. Available from product version 3.2.24.
Poles can be filtered by giving filtering parameters at HTTP querystring (see parameters).
Token issued for API consumer.
Offset to start returning results.
Limit number of results returned. Set to -1 to use maximum limit set in the environment. Default limit will be used if parameter is not specified. Special value -1 is available from product version 3.2.18.
Coordinate system to transform location to.
Example: srs=epsg:4326
Number of decimals to be returned with object location. If parameter is not specified the number of decimals is as precise as possible for current running instance. Available from product version 2024.4.
number of dimensions to be returned. Acceptable values are 2 and 3. If parameter is not specified the number of dimensions are as default for current product. Available from product version 2024.4.
Filters list by selected object field value. Supports structured queries via +__+ delimiter. Supports ending keywords via +__+ delimiter:
- For string fields: istartswith, startswith, iendswith, endswith, contains, icontains, isnull
- For numerics: gt, lt, gte, lte, isnull
- For spatial fields: contains, isnull, within, intersects, disjoint, touches, overlaps, covers, coveredby Examples:
+++usage_state__txt__istartswith=in+++
,+++plan__state__txt__startswith=In+++
,+++creation_date__gte=2019-01-02T15:32:01+++
,+++location__within=POLYGON ((641503.89 6944059.81, 641406.52 6943933.87, 641369.48 6943772.48, 641474.25 6943704.74, 641873.78 6943735.96, 641848.38 6943975.15, 641607.08 6944167.76, 641653.11 6944102.15, 641503.89 6944059.81))+++
Supports exclusive queries by field value using a not-operator preceeding the field lookup: Examples:+++not__type__txt__istartswith=Tie+++
,+++not__id=1390+++
Selects the object field to order the returned objects by. Can be used to sort in reverse order with '-' prefix. Can have several ordering rules separated by comma. Can be used only for object own fields and does not supports structured queries. Example: orderby=creator,-creation_date
A result response object.
{
"Next": "http://example.keypro.fi/api/v2/pole/?limit=10&offset=10",
"Previous": null,
"Results": [
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 10,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (457671.1584000000148080 6702815.5481000002473593 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 4921,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": 1.0,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "sergei",
"updated_ts": "2012-03-26T11:39:54Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 30,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (457635.0541000000084750 6702789.5608999999240041 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 4921,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:49Z",
"usage_state": 770
},
{
"angle": 88.16226162490963,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 410,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (457563.0280999999959022 6703141.6618999997153878 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:49Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 810,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (458260.5511999999871477 6696463.3857000004500151 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:48Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 830,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (458304.2228999999933876 6696397.4469999996945262 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:48Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 850,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (458330.0581000000238419 6696374.8507000003010035 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:48Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 870,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (458358.6934999999939464 6696350.1117000002413988 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:48Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 890,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (458178.6506999999983236 6696509.4546999996528029 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:48Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 910,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (458273.2860000000218861 6696463.2153000002726912 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:48Z",
"usage_state": 770
},
{
"angle": 90.0,
"branch_pole_number": "",
"checkout_date": null,
"created_by": "",
"created_ts": null,
"decay_class": null,
"height_accuracy": 117210,
"history_date": null,
"id": 930,
"impregnant": null,
"install_year": null,
"length": 0.0,
"line_part": "",
"location": "SRID=3067;POINT Z (458280.1165000000037253 6696418.9720000000670552 0.0000000000000000)",
"location_accuracy": 8301,
"mapper": "",
"mapping_method": null,
"material": 7341,
"owner": 2850,
"plan": null,
"pole_number": "",
"pole_type": 1601,
"remarks": "",
"renter": null,
"scale": null,
"stanchion": null,
"station_decay_class": null,
"survey_amount": "",
"telecom_area": null,
"updated_by": "KEYCOM_STAGE",
"updated_ts": "2010-07-22T10:53:48Z",
"usage_state": 770
}
],
"Total": 4757
}
Url to next page of poles list. Null if No next page exist
Url to previous page of poles list. Null if No previous page exist
List of fetched poles
Angle
Branch Pole
Checkout Date
Created by
Created timestamp
Pole decay class
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Height accuracy
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Checkout Date
Primary key
Pole impregnant
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Install year
Pole length
Line Part
Location of pole in EWKT
Location accuracy
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Mapper
Mapping method
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Pole material
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Pole owner
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan
District Heating Consumer Point Duct Diameter
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
District Heating Consumer Point Duct Diameter
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan Construction
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan Excavation
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
District Heating Consumer Point Limiter
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan Piping
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Agreed Delivery Date. Activated on request by customer.
Area Description. Activated on request by customer.
Begin Date
Contact Name. Not shown when displaying plan details in related objects. Activated on request by customer.
Contact Email Address. Activated on request by customer.
Contact Name. Activated on request by customer.
Contact phone number. Activated on request by customer.
Consumer Point Identification. Activated on request by customer.
Created by
Create Date
Customer Contact Date. Activated on request by customer.
Description
Desired Delivery Date. Activated on request by customer.
District Area
Geographical location as EWKT representation
Name of District Area
Duration. Activated on request by customer.
Expire Date
First contact person for plan. Not shown when displaying plan details in related objects. Activated on request by customer.
Unique id of plan
Implementation Date. Activated on request by customer.
Implementation Date. Activated on request by customer. Format is date with no time from product version 3.7.1.
Latest Implementation Date. Activated on request by customer. Format is date with no time from product version 3.7.1.
URL to the list of all Plans. Only shown when displaying plan details in related objects.
Geographical location. As EWKT representation
Louhi ID. Activated on request by customer.
Modifications. Not shown when displaying plan details in related objects. Activated on request by customer.
Name of Plan
Plan Network Type
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan Network Owner
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Offer Accepted Date. Activated on request by customer.
Offer ID. Activated on request by customer.
URL to the plan of which the plan is part of (subplan). Available from version 3.2.24. Activated on request by customer.
Plan remark. Not shown when displaying plan details in related objects. Activated on request by customer.
Plumbing Start Date. Activated on request by customer.
Property address. Not shown when displaying plan details in related objects. Activated on request by customer.
Plan Publicity
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan state
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Sum of cost for all related objects for the plan. Not shown when displaying plan details in related objects. Activated on request by customer.
Plan type
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Updated by
Update Date
Work Activities. Activated on request by customer.
Plan Work Phase
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Work Project. Activated on request by customer.
Plan Work Type
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan Work Type Main
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Plan Work Type Sub
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all contants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Pole number
Pole type
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Remarks. Available from product version 3.2.14.
Pole renter
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Scale
Pole stanchion
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Pole stanchion decay class
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Survey amount
Telecom area the pole is inside
Last updated by
Last updated timestamp
Pole state
Ending date time for availability
Beginning date time for availability
Is object deemed as available. Based on availability_start_ts and availability_end_ts values.
Group name of constant
Unique id of constant
Url to fetch all constants from this group
Logical textual value
Numeric value
Numeric value 2
Numeric value 3
Numeric value 4
Human readable textual representation
Total number of poles
Authentication credentials are missing or invalid
{
"details": "Authentication credentials were not provided"
}
Detailed description of error