Récupérer la cartographie des zones d'un resort

  • Information sur le produit
  • Contenu resort
  • 1 route
Comment récupérer les données de cartographie des zones d'un resort ?

Utilisez ce scénario pour récupérer les données géométriques nécessaires à l'affichage d'une carte des zones d'un resort. Il est utile pour construire une carte interactive, mettre en avant les principales zones du resort ou positionner des repères dans une expérience frontend.

La route retourne des structures GeoJSON et des métadonnées de zones qui peuvent être consommées directement par un composant cartographique ou transformées en couche de carte simplifiée.

Vue d'ensemble

Ce scénario explique comment récupérer les données cartographiques au niveau des zones d'un resort. La réponse combine des collections GeoJSON et des métadonnées de zones afin de représenter les espaces du resort, calculer des centres de carte ou enrichir une expérience de navigation avec des données de localisation structurées.

Prérequis

  • Un product_id valide pour le resort
  • Une x-api-key valide
  • Un header accept-language correspondant à une locale supportée

Résultat attendu

À la fin de ce scénario, vous pouvez alimenter un composant cartographique avec la géométrie des zones du resort et afficher des zones cliquables ou libellées dans une expérience publique.

1

Récupérer les données cartographiques des zones

Obligatoire

Cette route retourne les données cartographiques des zones d'un resort. Elle fournit à la fois la géométrie GeoJSON et les métadonnées nécessaires pour afficher une carte des espaces principaux du resort.

Prérequis

  • Un product_id valide, par exemple MPAC
  • Une x-api-key valide
  • Un header accept-language, par exemple fr-FR

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v0/products/MPAC/areas/geo_data"

Example answer

{
  "areas_geo_json": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "area_id": "DA"
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [[[ -7.978791 ]]]
        }
      }
    ]
  },
  "areas_center_geo_json": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "area_id": "DA"
        },
        "geometry": {
          "type": "Point",
          "coordinates": [ -7.978791 ]
        }
      }
    ]
  },
  "areas": [
    {
      "id": "AREA_MPAC_4T",
      "label": "Main Resort Area",
      "product_id": "MPAC",
      "pickable": true
    }
  ]
}

info: Les champs GeoJSON peuvent être injectés directement dans un composant cartographique. La collection areas apporte le libellé métier et l'identifiant de chaque zone pour gérer les interactions frontend.

Codes de réponse

  • 200 OK : les données cartographiques du resort sont retournées
  • 400 Bad Request : un paramètre obligatoire est manquant ou invalide
  • 404 Not Found : le product_id ne correspond à aucun resort connu
GET/v0/products/{product_id}/areas/geo_data
Voir plus