Api rest WalkYourPlace
WalkYourPlace contiene una api rest con el cual es posible conseguir los scores si se le envían los datos a traves de una URL en formato GET.
Las peticiones se hacen bajo la url http://146.155.17.19:17080/api y las variables se envían posterior a un '?' en la misma, éstos deben ir separados por un '&'
Por ejemplo:
http://146.155.17.19:17080/api?mode=walkscore&start_point=-33.465,-70.676
Contents
Modos de viaje
Walkscore model
Para obtener el score simulando el sistema que utiliza Walkscore.com son necesarias las siguientes variables en la petición:
- start_point : El punto a evaluar, las coordenadas deben ser escritas sin un espacio de separación. Por Ej: -33.465,-70.676
- radius (opcional): Es el radio de la circunferencia a evaluar, por defecto se encuentra con el valor 1.25.
- demographic (opcional): Es la opción demográfica con el cual queremos que los datos sean evaluados (default = Young Adult (20-30) ).
Ejemplos:
http://146.155.17.19:17080/api?mode=walkscore&start_point=-33.465,-70.676
http://146.155.17.19:17080/api?mode=walkscore&start_point=-33.465,-70.676&radius=1.5
Cycling model
Para obtener el score cuando una persona viaja en bicicleta son necesarias las siguientes variables en la petición:
- start_point : El punto a evaluar, las coordenadas deben ser escritas sin un espacio de separación. Por Ej: -33.465,-70.676
- biking_time_period : El tiempo de viaje en minutos.
- demographic (opcional): Es la opción demográfica con el cual queremos que los datos sean evaluados (default = Young Adult (20-30) ).
- Escenario (opcional): Es el escenario con el cual se requiere hacer la evaluación (default=1 información de OTP sobre el territorio chileno)
Ejemplos:
http://146.155.17.19:17080/api?mode=bike&start_point=-33.465,-70.676&biking_time_period=10
walking model
Para obtener el score cuando una persona caminando son necesarias las siguientes variables en la petición:
- start_point : El punto a evaluar, las coordenadas deben ser escritas sin un espacio de separación. Por Ej: -33.465,-70.676
- walking_time_period : El tiempo de caminata en minutos.
- walking_speed : La velocidad de caminata en [metros/segundos]
- demographic (opcional): Es la opción demográfica con el cual queremos que los datos sean evaluados (default = Young Adult (20-30) ).
- Escenario (opcional): Es el escenario con el cual se requiere hacer la evaluación (default=1 información de OTP sobre el territorio chileno)
Ejemplos:
Transit & walking model
Para obtener el score cuando una persona caminando y utilizando el transporte público son necesarias las siguientes variables en la petición:
- start_point : El punto a evaluar, las coordenadas deben ser escritas sin un espacio de separación. Por Ej: -33.465,-70.676
- walking_time_period : El tiempo de caminata en minutos.
- walking_speed : La velocidad de caminata en [metros/segundos]
- walking_start_time : Es la hora de comienzo del viaje, importante para las rutas del transporte público, se expresa en hora, minutos y segundos (Ej: 14:00:00)
- bus_waiting_time : Es el tiempo en minutos de cuanto esperaría a que el bus llegue al apradero
- bus_riding_time : Es el tiempo de viaje arriba de un transporte público
- demographic (opcional): Es la opción demográfica con el cual queremos que los datos sean evaluados (default = Young Adult (20-30) ).
- Escenario (opcional): Es el escenario con el cual se requiere hacer la evaluación (default=1 información de OTP sobre el territorio chileno)
Ejemplos
Car model
Para obtener el score cuando una persona viaja en auto son necesarias las siguientes variables en la petición:
- start_point : El punto a evaluar, las coordenadas deben ser escritas sin un espacio de separación. Por Ej: -33.465,-70.676
- car_time_period : El tiempo de viaje en minutos.
- demographic (opcional): Es la opción demográfica con el cual queremos que los datos sean evaluados (default = Young Adult (20-30) ).
- Escenario (opcional): Es el escenario con el cual se requiere hacer la evaluación (default=1 información de OTP sobre el territorio chileno)
Ejemplo:
http://146.155.17.19:17080/api?mode=car&start_point=-33.465,-70.676&car_time_period=10
Representación de resultados
Los resultados son entregados en formato JSON con la siguiente estructura:
{"walkshed":
{"type":"Polygon",
"coordinates":, # Coordenadas del polígono
"properties":
{"type": "Walkshed",
"area": 0, # Area abarcada por el polígono
"score": "0", # Puntaje de WYP
"crime_index": 0,
"color": ""
}
},
"poi":
{"type": "FeatureCollection",
"features": [ # Puntos considerados
{"type": "Feature",
"geometry":
{"type": "Point",
"coordinates": # Coordenadas del punto
},
"properties":
{"name": "", # Nombre del atractivo
"type": "", # Tipo
"icon": ""
}
},...] # Pueden ser muchos puntos más
}
}