Turn coordinates into trusted street addresses.

curl -s "https://api.revaddr.com/v1/reverse?lat=38.8977&lon=-77.0365" \
  -H "x-api-key: YOUR_API_KEY"

const res = await fetch(
  "https://api.revaddr.com/v1/reverse?lat=38.8977&lon=-77.0365",
  { headers: { "x-api-key": "YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data.result.formatted_address);

import requests

r = requests.get(
    "https://api.revaddr.com/v1/reverse",
    params={"lat": 38.8977, "lon": -77.0365},
    headers={"x-api-key": "YOUR_API_KEY"},
    timeout=10,
)
r.raise_for_status()
print(r.json()["result"]["formatted_address"])

package main

import (
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"time"
)

func main() {
	q := url.Values{}
	q.Set("lat", "38.8977")
	q.Set("lon", "-77.0365")

	req, err := http.NewRequest(
		http.MethodGet,
		"https://api.revaddr.com/v1/reverse?"+q.Encode(),
		nil,
	)
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "YOUR_API_KEY")

	client := &http.Client{Timeout: 10 * time.Second}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	if res.StatusCode != http.StatusOK {
		panic(fmt.Sprintf("HTTP %d: %s", res.StatusCode, body))
	}

	var payload struct {
		Result struct {
			FormattedAddress string `json:"formatted_address"`
		} `json:"result"`
	}
	if err := json.Unmarshal(body, &payload); err != nil {
		panic(err)
	}
	fmt.Println(payload.Result.FormattedAddress)
}

const url = new URL("https://api.revaddr.com/v1/reverse");
url.searchParams.set("lat", "38.8977");
url.searchParams.set("lon", "-77.0365");

const res = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const data = await res.json();
console.log(data.result.formatted_address);

using System.Net.Http.Headers;

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var url =
  "https://api.revaddr.com/v1/reverse?lat=38.8977&lon=-77.0365";
var json = await client.GetStringAsync(url);
Console.WriteLine(json);

// Parse with System.Text.Json as needed for result.formatted_address

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create(
        "https://api.revaddr.com/v1/reverse?lat=38.8977&lon=-77.0365"))
    .header("x-api-key", "YOUR_API_KEY")
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

// Requires libcurl (https://curl.se/libcurl/)
#include <curl/curl.h>
#include <string>
#include <iostream>

static size_t write_cb(char* ptr, size_t size, size_t nmemb, void* userdata) {
  auto* out = static_cast<std::string*>(userdata);
  out->append(ptr, size * nmemb);
  return size * nmemb;
}

int main() {
  CURL* curl = curl_easy_init();
  std::string body;
  struct curl_slist* headers = nullptr;
  headers = curl_slist_append(headers, "x-api-key: YOUR_API_KEY");

  curl_easy_setopt(curl, CURLOPT_URL,
    "https://api.revaddr.com/v1/reverse?lat=38.8977&lon=-77.0365");
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_cb);
  curl_easy_setopt(curl, CURLOPT_WRITEDATA, &body);

  CURLcode rc = curl_easy_perform(curl);
  if (rc == CURLE_OK) std::cout << body << std::endl;

  curl_slist_free_all(headers);
  curl_easy_cleanup(curl);
  return rc == CURLE_OK ? 0 : 1;
}

/* Requires libcurl (https://curl.se/libcurl/) */
#include <curl/curl.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

struct mem { char *data; size_t len; };

static size_t write_cb(char *ptr, size_t size, size_t nmemb, void *userdata) {
  size_t total = size * nmemb;
  struct mem *m = (struct mem *)userdata;
  char *p = realloc(m->data, m->len + total + 1);
  if (!p) return 0;
  m->data = p;
  memcpy(m->data + m->len, ptr, total);
  m->len += total;
  m->data[m->len] = '\0';
  return total;
}

int main(void) {
  CURL *curl = curl_easy_init();
  struct mem chunk = {0};
  struct curl_slist *headers = NULL;
  headers = curl_slist_append(headers, "x-api-key: YOUR_API_KEY");

  curl_easy_setopt(curl, CURLOPT_URL,
    "https://api.revaddr.com/v1/reverse?lat=38.8977&lon=-77.0365");
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_cb);
  curl_easy_setopt(curl, CURLOPT_WRITEDATA, &chunk);

  if (curl_easy_perform(curl) == CURLE_OK)
    printf("%s\n", chunk.data ? chunk.data : "");

  free(chunk.data);
  curl_slist_free_all(headers);
  curl_easy_cleanup(curl);
  return 0;
}