Geocoding API

Authorization: Bearer YOUR_JWT_TOKEN

{
  "message": "",
  "data": {
    "address": {
      "city": "Mountain View",
      "state": "California",
      "country": "US",
      "lat": 37.4223878,
      "long": -122.0841877
    }
  }
}

{
  "message": "",
  "data": {
    "address": {
      "city": "New York",
      "state": "New York",
      "country": "US",
      "lat": 40.6413111,
      "long": -73.7781391
    }
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Address parameter is required"
  }
}

{
  "error": {
    "code": "AUTH_ERROR",
    "message": "Invalid or missing authentication token"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "No results found for the specified address"
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please try again later."
  }
}

{
  "error": {
    "code": "SERVER_ERROR",
    "message": "An unexpected error occurred"
  }
}

GET /geo-locations/address/{address}

curl -X GET \
  'https://api-v1.compass.com/geo-locations/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'

curl -X GET \
  'https://api-v1.compass.com/geo-locations/address/JFK' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'

{
  "message": "Error message",
  "error": {
    "status": 400,
    "errorMessage": "Detailed error message"
  }
}

async function geocodeAddress(address) {
  try {
    const response = await fetch(
      `https://your-api-domain.com/geo-locations/address/${encodeURIComponent(address)}`,
      {
        headers: {
          'Authorization': 'Bearer YOUR_JWT_TOKEN'
        }
      }
    );
    
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    
    const data = await response.json();
    return data.data.address;
  } catch (error) {
    console.error('Geocoding error:', error);
    throw error;
  }
}

// Example usage
geocodeAddress('JFK')
  .then(location => console.log('Airport location:', location))
  .catch(console.error);