geo-mapper-api 0.1.2

A simple API for matching geospatial data to OSM IDs

Setup

This requires python>=3.9 but pretty specific versions of packages.

If this fails, try to create a new virtual environment with python 3.9 specifically for this package.

pip install geo_mapper_api

Requirements

It needs both the OSMConflation and GeoJSON data for the target area. You can obtain both from Inrix Data Download Service provided you have an access token or login credentials.

This conflation csv should have the following features:

Feature	Type	Example
XDSegID	Integer	136894283
OSMWayIDs	Integer	19659968
OSMWayDirections	String	N
WayStartOffset_m	Float	1077.78
WayEndOffset_m	Float	1851.31
WayStartOffset_percent	Float	33.706
WayEndOffset_percent	Float	57.897

While the geojson data should have the following features:

Feature	Type	Example
OID	Integer	7931440
XDSegID	Integer	156418860
PreviousXD	Float	nan
NextXDSegI	Float	395960459.0
FRC	Integer	4
RoadNumber	Float	nan
RoadName	String	DRHESSRD
LinearID	Float	nan
Country	String	UNITEDSTATES
State	String	TENNESSEE
County	String	HAYWOOD
District	Float	nan
PostalCode	String	38006
Miles	Float	0.5902665205613952
Lanes	Float	1.0
SlipRoad	Integer	0
SpecialRoa	Float	nan
RoadList	String	DRHESSRD
StartLat	Float	35.67248
StartLong	Float	-89.14147
EndLat	Float	35.666218484838986
EndLong	Float	-89.13571015096953
Bearing	String	S
XDGroup	Integer	2013963
ShapeSRID	Integer	4326
geometry	Geometry	LINESTRING

Usage

As long as you have both the maprelease-osmconflation and maprelease-geojson for a particular area, then it should just work. It requires the county name.

  from geo_mapper_api import inrix_to_osm
        
  DATA_DIR = "./data"
  geojson_path = os.path.join(DATA_DIR, 'USA_Tennessee.geojson')
  csv_path = os.path.join(DATA_DIR, 'USA_Tennessee.csv')
  county_name = ['WILLIAMSON']

  if __name__ == '__main__':
    df = inrix_to_osm.parallel(geojson_path, csv_path, county_name, threshold_distance=25)
    df.to_csv(f"{DATA_DIR}/williamson_county_tn_inrix_osm.csv", index=False)

df should have a column named county for each of the specified county and then the mapping, see the following example.

Feature	Type	Example
v	int	202619796
key	int	202705554
osmid	int	0
XDSegID	int	19495638
osm_geom	geometry	LINESTRING (-9927715.889573382 4219197.2535342...)
inrix_geom	geometry	LINESTRING (-9927119.795074416 4219027.3303308...)
distance	float	0.000000
within_threshold	bool	True

Development

Test data might be proprietary but these are just the maprelease data from Inrix. Please the csv and geojson in the tests/data folder and name them test.csv and test.geojson. Pytest should succeed.