HIV Testing Sites & Care Services Locator

Content From: HIV.govUpdated: September 6, 20223 min read
NOTICE: The Locator widget will be upgraded as of 9/26/2022. You must use the latest embed code available below.

The HIV Testing Sites & Care Services Locator is a first-of-its-kind, location-based search tool that allows you to search for testing services, housing providers, health centers and other service providers near your current location.

Adding Locator Widget to Site

 

HIV.gov has developed a new layout for the HIV.gov locator widget. In order to allow users the flexibility to embed this widget conveniently within their site, the widget is now responsive, meaning it will automatically resize based on the dimensions of the HTML container that you put it in. Please reference the items below, including embed codes and specific descriptions of the widget and feel free to embed on your site.

HIV.gov Locator Widget

This locator widget is designed to fit automatically resize based on the dimensions of the HTML container that you put it in.

Copy the HIV.gov Locator Widget Code:

<!-- LOCATOR.HIV.GOV WIDGET --><script type="module" src="https://locator.hiv.gov/build/locator-widget.esm.js"></script><script nomodule src="https://locator.hiv.gov/build/locator-widget.js"></script><locator-widget></locator-widget>

Instructions

A one-stop search tool for consumers looking for HIV/AIDS service providers.

The tool takes advantage of open data from HHS agencies such as CDC, SAMHSA and HRSA, along with other Federal departments like HUD, to allow searches across many service provider databases at one time. Results are displayed on a dynamic map, marking each service provider near the location you searched. You can view the provider's contact information, which services they provide, and get directions to the provider's location.

How it works

  1. If you know the 5-digit ZIP code of the area where you are, you may get better results. If you don't, you can just use the nearest city and state, like Baltimore, MD, or San Diego, CA.
  2. You can click on the markers on the map to get more information about each location.
  3. You can also view the locations in a list view. Click on the list button.
  4. To get directions to a service provider's location, you can enter the specific address for where you'd like to start from, and directions will be displayed.

API

The HIV Testing Sites & Care Services Locator is a first-of-its-kind, location-based search tool that allows you to search for testing services, housing providers, health centers and other service providers near your current location.

What is an API?

API stands for application programming interface, and is a way for data to be shared in a flexible and open way. This allows for many different uses of the data, by many different groups and individuals.

What data is available through this API?

All of the same location data that you can find through the Locator tool: service provider names, addresses, phone numbers, locations and so on, categorized by service type.

How do I access the API?

Please send us an email at contact HIV.gov to request access to our API.

The following parameters are available:

zip

Perform a search by ZIP Code. Must be a 5 digit number.

lat & long

Perform a search using latitude and longitude coordinates. If lat, long and zip are provided, lat and long will be ignored.

services

A comma separated list of the types of services to search. The following are the currently available service types:

  • testing
  • PrEP
  • self-testing
  • housing
  • clinics
  • ryanwhite
  • mentalhealth
  • substanceabuse
  • familyplanning

distance

Adjust the search distance, in miles. Must be an integer between 1 and 50. Default distance is 5 miles.

format

Determines the format of the returned data. Currently available formats are:

  • json (default)
  • html

callback

If a callback parameter is included, the response will be sent using JSON-P.