Geo
API Reference
Geocode & Shortage Designations
Geocode Web service is designed get an address's geographic coordinates. This method can also be used to validate and standardize an address even if you don't need geographic coordinates. This web service is also able to return health profession shortage designations of an address that is of California.
Geocode web service takes a full or partial address string and returns a matching address sorted by best match in JSON format.
Below is an example web service URL with some parameters.
https://geo.hcai.ca.gov/service/geocode?key=YOUR_KEY_HERE&findshortagedesignations=true&address=4081+E+Olympic+Blvd,+Los+Angeles,+CA+90023&calreachdoctype=Parameters
- key (required)
- An api key must be provided to use this service. The API is for HCAI applications only and not open to public.
- address (required)
- Input address
- maxlocations
- Returns requested number of locations matching the search criteria. Currently it is capped at 10 locations per search and default is 5.
- findshortagedesignations
- When set to true, reponse will include shortage designations for each address returned in response.
- calreachdoctype
- Given this parameter, the Area of Unmet Need (in_umn) flag may be determined differently. Currently SongBrown program may require this flag to be computed differently for various programs. For Example, An address's Area of Unmet Need flag(in_umn) Registered Nurse Special Program's application doesn't care about any other flags other than Registered Nurse Shortage Area (rnsa).
Json Response
Geocode service may return multiple addresses if a partial address was given. Below is a an example of that
https://geo.hcai.ca.gov/service/geocode?key=YOUR_KEY_HERE&findshortagedesignations=true&address=4081+E+Olympic+Blvd,+Los+Angeles,+CA+90023{
"addresses": [{
"ExtensionData": {},
"Attributes": {
"ExtensionData": {},
"AddressPrecision": "ROOFTOP",
"AddressType": "premise",
"Source": "Google",
"place_id": "ChIJTe2Taj_PwoAReB4E90-vIwY"
},
"City": "Los Angeles",
"County": "Los Angeles",
"FacilityInfo": {
"ExtensionData": {},
"Category": "Hospital",
"Control_Category": "Investor Owned",
"Disproportionate_Share_Hospital": true,
"Name": "Los Angeles Community Hospital",
"Rural_Hospital": false,
"SongBrown_In_Umn": true,
"SongBrown_In_Umn_Description": "Disproportionate Share Hospital",
"Teaching_Hospital": false,
"Type": "General Acute Care Hospital"
},
"FullAddress": "4081 E Olympic Blvd, Los Angeles, CA 90023",
"HealthServiceArea": {
"ExtensionData": {},
"Name": "Los Angeles",
"Number": 11
},
"LAServicePlanningArea": {
"ExtensionData": {},
"Name": "East",
"Number": 7
},
"Latitude": 34.0193498,
"Longitude": -118.1865467,
"PoliticalDistricts": [{
"ExtensionData": {},
"Label_Long": "51st Assembly District",
"Label_Short": "AD-51",
"Member": "Wendy Carrillo",
"Number": 51,
"Party": "Democrat",
"Type": "Assembly District",
"Website": "https://a51.asmdc.org/"
}, {
"ExtensionData": {},
"Label_Long": "6th Congressional District",
"Label_Short": "CD-06",
"Member": "Lucille Roybal-Allard",
"Number": 6,
"Party": "Democrat",
"Type": "Congressional District",
"Website": "https://roybal-allard.house.gov/"
}, {
"ExtensionData": {},
"Label_Long": "24th Senate District",
"Label_Short": "SD-24",
"Member": "Maria Elena Durazo",
"Number": 24,
"Party": "Democrat",
"Type": "Senate District",
"Website": "https://senate.ca.gov/sd24"
}],
"ShortageDesignations": {
"ExtensionData": {},
"FQHC": [],
"census_tract": "5313.02",
"central_valley": false,
"county": null,
"endowment_communities": false,
"hpsa_dc": false,
"hpsa_dc_date": "",
"hpsa_dc_formal_ratio": null,
"hpsa_dc_id": null,
"hpsa_dc_percent_of_population_below_poverty_level": null,
"hpsa_dc_score": 0,
"hpsa_mh": true,
"hpsa_mh_date": "11/5/2010 12:00:00 AM",
"hpsa_mh_formal_ratio": "27417:1",
"hpsa_mh_id": "7067378960",
"hpsa_mh_percent_of_population_below_poverty_level": "26.9",
"hpsa_mh_score": 10,
"hpsa_pc": true,
"hpsa_pc_date": "5/29/2012 12:00:00 AM",
"hpsa_pc_formal_ratio": "6565:1",
"hpsa_pc_id": "1061952432",
"hpsa_pc_percent_of_population_below_poverty_level": "26.9",
"hpsa_pc_score": 11,
"in_umn": true,
"mssa_definition": "Urban",
"mssa_id": "78.2d",
"mua": false,
"mup": false,
"pcsa": false,
"pcsa_score":0,
"rnsa": true,
"rnsa_severity": "High"
},
"State": "CA",
"Street": "4081 E Olympic Blvd",
"Zipcode": "90023"
}],
"response": "success"
}
Geocode service may not be able to find an address matching the input. Below is an example of how that is handled and reported.
https://geo.hcai.ca.gov/service/geocode?key=YOUR_KEY_HERE&address=400+wrong+Street+sacramento+ca{
response: "failed",
reason: "Address not found"
}
GetHPSDesignations
This method allows you to get health profession shortage designations of a latitude and longitude. Remember that this will only work for coordinates that are of California.
Below is an example of this web service URL with some parameters.
https://geo.hcai.ca.gov/service/gethpsdesignations?key=YOUR_KEY_HERE&latitude=38.5732617&longitude=-121.5047861&calreachdoctype=Latitude and Longitude provided above are of 4081 E Olympic Blvd, Los Angeles, CA 90023
Parameters
- key (required)
- An api key must be provided to use this service. The API is for HCAI applications only and not open to public.
- latitude (required)
- Latitude of the address that you want to find the shortage designations for.
- longitude(required)
- Longitude of the address that you want to find the shortage designations for.
- calreachdoctype
- Given this parameter, the Area of Unmet Need (in_umn) flag may be determined differently. Currently SongBrown program may require this flag to be computed differently for various programs. For Example, An address's Area of Unmet Need flag(in_umn) Registered Nurse Special Program's application doesn't care about any other flags other than Registered Nurse Shortage Area (rnsa).
Json Response
{
"PoliticalDistricts": [{
"ExtensionData": {},
"Label_Long": "51st Assembly District",
"Label_Short": "AD-51",
"Member": "Wendy Carrillo",
"Number": 51,
"Party": "Democrat",
"Type": "Assembly District",
"Website": "https://a51.asmdc.org/"
}, {
"ExtensionData": {},
"Label_Long": "6th Congressional District",
"Label_Short": "CD-06",
"Member": "Lucille Roybal-Allard",
"Number": 6,
"Party": "Democrat",
"Type": "Congressional District",
"Website": "https://roybal-allard.house.gov/"
}, {
"ExtensionData": {},
"Label_Long": "24th Senate District",
"Label_Short": "SD-24",
"Member": "Maria Elena Durazo",
"Number": 24,
"Party": "Democrat",
"Type": "Senate District",
"Website": "https://senate.ca.gov/sd24"
}],
"longitude": -118.1865467,
"response": "success",
"ShortageDesignations": {
"ExtensionData": {},
"FQHC": null,
"census_tract": "5313.02",
"central_valley": false,
"county": "Los Angeles",
"endowment_communities": false,
"hpsa_dc": false,
"hpsa_dc_date": "",
"hpsa_dc_formal_ratio": null,
"hpsa_dc_id": null,
"hpsa_dc_percent_of_population_below_poverty_level": null,
"hpsa_dc_score": 0,
"hpsa_mh": true,
"hpsa_mh_date": "11/5/2010 12:00:00 AM",
"hpsa_mh_formal_ratio": "27417:1",
"hpsa_mh_id": "7067378960",
"hpsa_mh_percent_of_population_below_poverty_level": "26.9",
"hpsa_mh_score": 10,
"hpsa_pc": true,
"hpsa_pc_date": "5/29/2012 12:00:00 AM",
"hpsa_pc_formal_ratio": "6565:1",
"hpsa_pc_id": "1061952432",
"hpsa_pc_percent_of_population_below_poverty_level": "26.9",
"hpsa_pc_score": 11,
"in_umn": false,
"mssa_definition": "Urban",
"mssa_id": "78.2d",
"mua": false,
"mup": false,
"pcsa": false,
"pcsa_score":0,
"rnsa": true,
"rnsa_severity": "High"
},
"LAServicePlanningArea": {
"ExtensionData": {},
"Name": "East",
"Number": 7
},
"HealthServiceArea": {
"ExtensionData": {},
"Name": "Los Angeles",
"Number": 11
},
"latitude": 34.0193498
}