Menu
Translate
Text Size Print Share

HIV Testing Sites & Care Services Locator

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

AIDS.gov has developed two different layouts for the AIDS.gov locator widget. In order to allow users the flexibility to place this widget conveniently within their site, there is a horizontal version and a vertical version. Each widget functions identically, so there is no difference between the two other than aesthetics. Please reference the items below, including embed codes and specific descriptions of each widget and feel free to place on your site.

AIDS.gov Locator Widget
Horizontal Layout

This locator widget is designed to fit in wider locations, approximately 340 pixels wide by 140 pixels high.

Copy the AIDS.gov Locator Widget Code:

<noscript><div style="height:115px;position:relative;width:314px;background:url(http://locator.aids.gov/images/bg_widget-8bit.png) no-repeat;padding-left:19px;"><strong style="padding-top:6px;color:#fff;display:block;font-family:Trebuchet MS;font-size:14px;line-height:16px;">Find HIV/AIDS Prevention & Service Providers</strong><p style="font-size:9px;margin: 3px 0 4px;color:#fff;">Enter your address, city and state, or ZIP Code:</p><form action="http://locator.aids.gov/index.php" style="margin:0;"><label style="margin-left:22px;"><input type="text" name="location" style="border:0;font-size:11px;width:230px;"/></label><button type="submit" style="background:none;border:none;cursor:pointer;height:40px;margin-top:5px;padding:0;text-indent:-999em;overflow:hidden;vertical-align:middle;width:40px;">GO</button><input type="hidden" name="text_only" value="true" /></form><p style="font-size:9px;margin: 10px 0 0;color:#fff;">For more information on this widget, please visit <a href="http://aids.gov/locator" style="color:#fff;">AIDS.gov</a>.</p></div></noscript><script type="text/javascript" src="http://locator.aids.gov/widget.js"></script>

 

AIDS.gov Locator Widget
Vertical Layout

This locator widget is designed to fit in more narrow locations (navigation and sidebars, for example), approximately 130 pixels wide by 350 pixels high.

Copy the AIDS.gov Locator Widget Code:

<noscript><div style="height:350px;position:relative;width:132px;background:url(http://locator.aids.gov/images/bg_widget_narrow-8bit.png) no-repeat;padding-left:13px;"><strong style="padding-top:6px;color:#fff;display:block;font-family:Trebuchet MS;font-size:12px;line-height:1.18;margin-bottom:5px;">Find HIV/AIDS<br/>Prevention & Service<br/>Providers</strong><form action="http://locator.aids.gov/index.php" style="margin:0;"><label style="margin-left:18px;"><input type="text" name="location" style="border:0;font-size:11px;width:65px;"/></label><button type="submit" style="background:none;border:none;cursor:pointer;height:34px;margin:5px 0 0 5px;padding:0;text-indent:-999em;overflow:hidden;vertical-align:middle;width:34px;">GO</button><input type="hidden" name="text_only" value="true" /></form><div style="background:url(http://locator.aids.gov/images/bg_tab_narrow-8bit.png) no-repeat scroll 0 0;height:200px;left:4px;overflow:hidden;padding:10px 12px;position:absolute;top:100px;width:113px;z-index:1;font-family:arial,sans-serif;font-size:11px;line-height:15px;"><p>Enter your location, such as: "Washington, DC", or "20002".</p><p>For more information on this widget, please visit <a href="http://aids.gov/locator">AIDS.gov</a>.</p><p>Please contact <a href="mailto:contact@aids.gov">contact@aids.gov</a> with any comments or concerns.</p></div></div></noscript><script type="text/javascript" src="http://locator.aids.gov/narrowwidget.js"></script>

 

AIDS.gov Locator Widget
Simple Layout

This locator widget is designed to fit in smaller locations, approximately 150 pixels wide by 30 pixels high.

Copy the AIDS.gov Locator Widget Code:

<noscript><form action="http://locator.aids.gov/index.php" style="margin:0;"><label style="margin-left:22px;"><input type="text" name="location" style="border:1;font-size:11px;width:230px;"/></label><button type="submit" style="background:none;cursor:pointer;height:20px;padding:0;text-indent:-999em;overflow:hidden;vertical-align:middle;width:40px;">GO</button><input type="hidden" name="text_only" value="true" /></form></noscript><script type="text/javascript" src="http://locator.aids.gov/widget-clean.js"></script>

 

CDC HIV Testing Sites
Locator Widget

This locator widget searches HIV Testing locations by default, and allows for searching other types of service providers through the "More" tab. It is designed to fit in more narrow locations (navigation and sidebars, for example), approximately 130 pixels wide by 350 pixels high.

Copy the CDC HIV Testing Sites Locator Widget Code:

<noscript><div style="height:352px;position:relative;width:147px;background:url(http://locator.aids.gov/images/cdc/bg_widget_narrow-8bit.png) no-repeat;"><strong style="text-align:center;padding-top:8px;color:#fff;display:block;font-family:Trebuchet MS;font-size:12px;line-height:1.18;margin-bottom:5px;">Find HIV/AIDS<br/>Prevention &amp; Service<br/>Providers</strong><form action="http://locator.aids.gov/index.php" style="margin:0;"><label style="margin-left:32px;"><input type="text" name="location" style="border:0 none;font-size:11px;width:65px;"/></label><button type="submit" style="background:none;border:none;cursor:pointer;height:34px;margin-top:5px;padding:0;text-indent:-999em;overflow:hidden;vertical-align:middle;width:34px;">GO</button><input type="hidden" name="text_only" value="true" /></form><div style="background:url(http://locator.aids.gov/images/cdc/bg_tab_narrow-8bit.png) no-repeat scroll 0 0;height:200px;left:5px;overflow:hidden;padding:10px 12px;position:absolute;top:100px;width:113px;z-index:1;font-family:arial,sans-serif;font-size:11px;line-height:15px;"><p>Enter your location, such as: "Washington, DC", or "20002".</p><p>For more information on this widget, please visit <a href="http://aids.gov/locator" style="color:#1111CC;">AIDS.gov</a>.</p><p>Please contact <a href="mailto:contact@aids.gov" style="color:#1111CC;">contact@aids.gov</a> with any comments or concerns.</p></div></div></noscript><script type="text/javascript" src="http://locator.aids.gov/cdcwidget.js"></script>

 

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 expand the list on the right-hand side of the screen to see the names of all the locations. Clicking a name will also provide more information.
  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?

Through http://locator.aids.gov/data. 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
  • 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.

What will the data I get back look like?

If you don't request a different format, the data in the response will be in JSON format. Here's a quick example:

{
  "title": "HIV/AIDS Prevention & Service Providers",
  "link": "http://locator.dev/data?zip=37206",
  "updated": "2012-01-29T15:15:51-0600",
  "stat": "ok",
  "services": [
    {
      "title": "Search Results from CDC - Locate HIV/AIDS Testing Sites",
      "link": "http://cdcnpin.org/hivTestLocatorFeed/feed.aspx?radius=5&zip=37206",
      "author": "CDC NPIN",
      "id": "tag:cdcnpin.org,2009-09-15:/npinwebservices/NPINDataWebservices",
      "updated": "2009-09-15T00:00:00-05:00",
      "providers": [
        {
          "title": "Cayce Family Clinic",
          "link": "http://www.hivtest.org/Detail.aspx?id=21952",
          "id": "tag:hivtest.org,2000-03-20:/search/Detailx.asp?id=21952",
          "streetAddress": "617 S 8th St",
          "locality": "Nashville",
          "region": "TN",
          "postalCode": "37206",
          "telephone": "615-226-1695",
          "categories": "Chlamydia Testing, Conventional HIV Blood Testing...",
          "point": {
              "lat": "36.1677602",
              "long": "-86.7548626"
          },
          "updated": "2012-01-12T09:08:19.0000000-05:00"
        }
      ]
    }
  ]
}

Could I see some examples?

Sure, here are a few example requests:

http://locator.aids.gov/data?lat=36.180774&long=-86.735863

http://locator.aids.gov/data?lat=36.180774&long=-86.735863&distance=10

http://locator.aids.gov/data?lat=36.180774&long=-86.735863&format=html

http://locator.aids.gov/data?lat=36.180774&long=-86.735863&format=xml&distance=30

Below is an example which simply lists the results:

And one which displays the results on a map: