Endpoints

Geographic Search

Geographic Course Search

The GG365 Golf API provides powerful geographic search capabilities for finding courses by location.

Search by Coordinates

Code
 
GET /geo-search/coordinates

Find golf courses within a specified radius from a given latitude and longitude.

Query Parameters

Parameter	Type	Description
lat	float	Latitude of the center point (required)
lng	float	Longitude of the center point (required)
radius	integer	Search radius in kilometers (default: 50, max: 200)
limit	integer	Maximum number of results to return (default: 20, max: 100)
sortBy	string	Sort order: "distance" (default) or "name"

Response

Code
 
{
  "data": [
    {
      "id": "clx9k2m1a0001",
      "name": "Marbella Golf Country Club",
      "slug": "marbella-golf-country-club",
      "country": "ES",
      "region": "Andalusia",
      "city": "Marbella",
      "courseType": "resort",
      "holes": 18,
      "thumbnailUrl": "https://cdn.golfglobe365.com/prod/course/marbella-golf-thumb.jpg",
      "minPrice": 75.00,
      "currency": "EUR",
      "latitude": 36.5092,
      "longitude": -4.8833,
      "distanceInKm": 12.4
    }
  ],
  "meta": {
    "center": {
      "latitude": 36.5400,
      "longitude": -4.9100
    },
    "radius": 50,
    "totalResults": 8
  }
}

Search by Region

Code
 
GET /geo-search/region

Find golf courses within a specific region defined by a bounding box.

Query Parameters

Parameter	Type	Description
north	float	Northern boundary latitude (required)
south	float	Southern boundary latitude (required)
east	float	Eastern boundary longitude (required)
west	float	Western boundary longitude (required)
limit	integer	Maximum number of results to return (default: 20, max: 100)
sortBy	string	Sort order: "name" (default), "country"

Response

Code
 
{
  "data": [
    {
      "id": "clx9k2m1a0001",
      "name": "Marbella Golf Country Club",
      "slug": "marbella-golf-country-club",
      "country": "ES",
      "region": "Andalusia",
      "city": "Marbella",
      "courseType": "resort",
      "holes": 18,
      "thumbnailUrl": "https://cdn.golfglobe365.com/prod/course/marbella-golf-thumb.jpg",
      "minPrice": 75.00,
      "currency": "EUR",
      "latitude": 36.5092,
      "longitude": -4.8833
    }
  ],
  "meta": {
    "boundingBox": {
      "north": 37.0000,
      "south": 36.0000,
      "east": -4.0000,
      "west": -5.0000
    },
    "totalResults": 15
  }
}

Search Near Address

Code
 
GET /geo-search/address

Find golf courses near a specified address or location name.

Query Parameters

Parameter	Type	Description
address	string	Address, city, or location name (required)
radius	integer	Search radius in kilometers (default: 50, max: 200)
limit	integer	Maximum number of results to return (default: 20, max: 100)
sortBy	string	Sort order: "distance" (default) or "name"

Response

Same format as the Search by Coordinates response.

Search by Country and Region

Code
 
GET /geo-search/country-region

Find golf courses in a specific country and optionally a specific region within that country.

Query Parameters

Parameter	Type	Description
country	string	Country name or code (required)
region	string	Region or state name (optional)
limit	integer	Maximum number of results to return (default: 20, max: 100)
page	integer	Page number for pagination (default: 1)

Response

Code
 
{
  "data": [
    {
      "id": "clx9k2m1a0001",
      "name": "Marbella Golf Country Club",
      "slug": "marbella-golf-country-club",
      "country": "ES",
      "region": "Andalusia",
      "city": "Marbella",
      "courseType": "resort",
      "holes": 18,
      "thumbnailUrl": "https://cdn.golfglobe365.com/prod/course/marbella-golf-thumb.jpg",
      "minPrice": 75.00,
      "currency": "EUR",
      "latitude": 36.5092,
      "longitude": -4.8833
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "totalItems": 45,
      "totalPages": 3
    },
    "country": "ES",
    "region": "Andalusia"
  }
}

Combining Geographic Search with Filters

You can combine geographic search with additional filters by adding filter parameters:

Code
 
GET /geo-search/coordinates?lat=36.5400&lng=-4.9100&radius=50&courseType=resort&holesCount=18

This allows you to find courses in a specific location that also meet certain criteria.