Ultimaps MCP

आधिकारिक

डेटा को मानचित्र छवियों में बदलें: दुनिया, देशों, राज्यों, काउंटियों और ZIP कोड के कोरोप्लेथ, श्रेणी और पिन मानचित्र।

Ultimaps MCP के साथ आप क्या कर सकते हैं?

डेटा से मैप रेंडर करें — अपने सहायक से कहें कि क्षेत्र मानों को लेजेंड और शीर्षक के साथ रंगीन कोरोप्लेथ मैप इमेज में बदल दे।
विशिष्ट क्षेत्रों को हाइलाइट करें — ऐसा मैप माँगें जिसमें नामित राज्य, काउंटी या देश चुने गए हेक्स रंगों से भरे हों।
निर्देशांक द्वारा पिन लगाएँ — दिए गए अक्षांशों और देशांतरों पर लेबल किए गए पिन माँगें, वैकल्पिक रूप से कोरोप्लेथ के साथ संयोजित।
उपलब्ध मैप सूचीबद्ध करें — अपने सहायक से पूछवाएँ कि कौन-से मैप ID मौजूद हैं, जैसे united-states या europe।
रेंडर करने से पहले क्षेत्र कुंजियाँ जाँचें — एक ड्राई रन चलाएँ ताकि देख सकें कि कौन-से क्षेत्र नाम मेल खाए, कौन-से सुधारे गए और कौन-से विफल रहे।
किसी मैप के क्षेत्र खोजें — पूछें कि किसी दिए गए मैप में कौन-से क्षेत्र हैं ताकि आप रेंडर के लिए मान्य कुंजियाँ बना सकें।

दस्तावेज़

मैप इमेज API

डेटा अंदर, मैप इमेज बाहर। एक URL किसी भी देश, राज्य, काउंटी या ZIP क्षेत्र का कोरोप्लेथ, श्रेणी या पिन मैप PNG के रूप में रेंडर करता है। कोई खाता नहीं, कोई कुंजी नहीं, आपके स्टैक में कोई मैप लाइब्रेरी नहीं।

https://api.ultimaps.com/v1/renders?spec=%7B%22mapId%22%3A%22united-states%22%2C%22regions%22%3A%7B%22US-CA%22%3A%22%231D4ED8%22%2C%22US-TX%22%3A%22%23F59E0B%22%2C%22New%20York%22%3A%22%2310B981%22%7D%2C%22title%22%3A%7B%22text%22%3A%22Where%20we%20operate%22%7D%2C%22style%22%3A%7B%22labels%22%3A%7B%22show%22%3Atrue%7D%7D%2C%22output%22%3A%7B%22width%22%3A1200%7D%7D

बस इतना ही अनुरोध है। spec पैरामीटर URL-एन्कोडेड JSON है, और प्रतिक्रिया स्वयं इमेज है।

US map rendered by the Ultimaps API, every state labelled, with California, Texas and New York filled in

बाईं ओर के URL द्वारा लाइव रेंडर किया गया, 24 घंटे के लिए कैश किया गया।

कहीं भी फिट हो जाता है

URL इमेज लौटाता है, इसलिए यह <img> टैग, README, Notion पेज या Google Sheets सेल में काम करता है।

GET या POST

GET हर फ़ीचर लेता है लेकिन स्पेक को 6KB तक सीमित रखता है, और यह हमेशा 1600px तक की बिना-कुंजी PNG रेंडर करता है। बड़े पेलोड के लिए वही JSON POST /v1/renders पर भेजें, बड़े कैनवास के लिए कुंजी, या SVG के लिए Pro कुंजी।

बाद में संपादन योग्य

हर इमेज में एक Link हेडर होता है जो रेंडर को Ultimaps Studio में एक वास्तविक मैप के रूप में खोलता है। बिना-कुंजी रेंडर लिंक वाले किसी भी व्यक्ति के लिए खुलते हैं। कुंजी वाला रेंडर केवल उस कुंजी के वर्कस्पेस में साइन इन किए व्यक्ति के लिए खुलता है।

कुकबुक

छह पूर्ण अनुरोध। हर एक को CI में लाइव अनुरोध स्कीमा के विरुद्ध मान्य किया जाता है, इसलिए आप उन्हें जैसे हैं वैसे कॉपी कर सकते हैं, mapId और मान बदल सकते हैं, और चल पड़ सकते हैं। प्रत्येक इमेज वही प्रतिक्रिया है जो उसके बगल वाले अनुरोध ने लौटाई, वॉटरमार्क सहित, मुफ़्त बिना-कुंजी टियर पर।

कुछ क्षेत्रों को हाइलाइट करें

सबसे सरल उपयोगी अनुरोध। आप क्षेत्रों के नाम देते हैं और हर एक को एक रंग देते हैं। बाकी सब मैप डिफ़ॉल्ट लेता है।

{
  "mapId": "united-states",
  "regions": {
    "US-CA": "#1D4ED8",
    "US-TX": "#F59E0B",
    "New York": "#10B981"
  },
  "title": {
    "text": "Where we operate"
  },
  "style": {
    "labels": {
      "show": true
    }
  },
  "output": {
    "width": 1200
  }
}

curl https://api.ultimaps.com/v1/renders \
  -H "Content-Type: application/json" \
  -d '{
    "mapId": "united-states",
    "regions": {
      "US-CA": "#1D4ED8",
      "US-TX": "#F59E0B",
      "New York": "#10B981"
    },
    "title": {
      "text": "Where we operate"
    },
    "style": {
      "labels": {
        "show": true
      }
    },
    "output": {
      "width": 1200
    }
  }' \
  -o map.png

Map of the United States titled "Where we operate", with California blue, Texas orange and New York green, every other state in the theme default and labeled with its abbreviation

संयुक्त राज्य का मैप जिसका शीर्षक "Where we operate" है, कैलिफ़ोर्निया नीला, टेक्सास नारंगी और न्यूयॉर्क हरा, बाकी हर राज्य थीम डिफ़ॉल्ट में और अपने संक्षेप के साथ लेबल किया गया

क्षेत्र कुंजियाँ लचीली हैं। "US-CA", "California" और "CA" सभी एक ही क्षेत्र तक पहुँचते हैं।
रंग हेक्स स्ट्रिंग हैं। जिन क्षेत्रों को आप छोड़ देते हैं वे थीम डिफ़ॉल्ट रखते हैं।
"style.labels.show" हर क्षेत्र का नाम प्रिंट करता है। कुछ क्षेत्रों को बिना लेबल छोड़ने के लिए, उनकी कुंजियाँ "style.labels.hide" में सूचीबद्ध करें।

इस रेंडर को नए टैब में खोलें

संख्याओं से कोरोप्लेथ

API को कच्चे मान दें और यह वर्ग, रंग और लेजेंड चुन लेता है। यही वह अनुरोध है जो अधिकांश लोग चाहते हैं।

{
  "mapId": "united-states",
  "choropleth": {
    "values": {
      "California": 39.5,
      "Texas": 30.5,
      "Florida": 22.6,
      "New York": 19.6,
      "Pennsylvania": 13,
      "Illinois": 12.5,
      "Ohio": 11.8,
      "Georgia": 11,
      "North Carolina": 10.8,
      "Michigan": 10
    },
    "type": "groups",
    "palette": "blues",
    "classes": 5,
    "method": "quantile",
    "noDataColor": "#EEEEEE",
    "noData": true,
    "format": {
      "decimals": 1,
      "suffix": "M"
    }
  },
  "legend": {
    "position": "left",
    "title": "Population (millions)"
  },
  "title": {
    "text": "Population by state, 2025"
  },
  "style": {
    "labels": {
      "show": true,
      "content": "value"
    }
  },
  "output": {
    "width": 1600,
    "scale": 1
  }
}

curl https://api.ultimaps.com/v1/renders \
  -H "Content-Type: application/json" \
  -d '{
    "mapId": "united-states",
    "choropleth": {
      "values": {
        "California": 39.5,
        "Texas": 30.5,
        "Florida": 22.6,
        "New York": 19.6,
        "Pennsylvania": 13,
        "Illinois": 12.5,
        "Ohio": 11.8,
        "Georgia": 11,
        "North Carolina": 10.8,
        "Michigan": 10
      },
      "type": "groups",
      "palette": "blues",
      "classes": 5,
      "method": "quantile",
      "noDataColor": "#EEEEEE",
      "noData": true,
      "format": {
        "decimals": 1,
        "suffix": "M"
      }
    },
    "legend": {
      "position": "left",
      "title": "Population (millions)"
    },
    "title": {
      "text": "Population by state, 2025"
    },
    "style": {
      "labels": {
        "show": true,
        "content": "value"
      }
    },
    "output": {
      "width": 1600,
      "scale": 1
    }
  }' \
  -o map.png

Choropleth map of US state population in 2025, shaded across five blue quantile classes with the break labels in a legend and each value printed in millions on its state

2025 में अमेरिकी राज्य जनसंख्या का कोरोप्लेथ मैप, पाँच नीले क्वांटाइल वर्गों में छायांकित, लेजेंड में ब्रेक लेबल और प्रत्येक मान उसके राज्य पर लाखों में मुद्रित

"type", "classes" और "method" छोड़ दें और API उन्हें आपके डेटा से पहचान लेता है।
"palette" 26 अंतर्निहित पैलेट में से कोई भी लेता है। "noDataColor" उन क्षेत्रों को रंगता है जिन्हें आपका डेटा कवर नहीं करता, और "noData" उनके लिए लेजेंड में एक "No data" पंक्ति जोड़ता है।
"legend.title" बताता है कि रंग क्या मापते हैं। हर डेटा लेजेंड को एक दें।
"format" नियंत्रित करता है कि संख्याएँ लेजेंड में और मैप पर कैसे प्रिंट होती हैं, इमेज फ़ॉर्मेट नहीं।
"style.labels.content" यहाँ "value" है। "name_value" राज्य का नाम उसके नीचे संख्या के साथ प्रिंट करता है।

इस रेंडर को नए टैब में खोलें

पिन

अक्षांश और देशांतर मार्कर। पिन बाकी सब के साथ संयोजित होते हैं, इसलिए आप उन्हें कोरोप्लेथ पर या सादे मैप पर डाल सकते हैं।

SVG आउटपुट के लिए Pro कुंजी चाहिए। किसी भी टियर पर PNG के लिए "format" छोड़ दें।

{
  "mapId": "united-states",
  "style": {
    "theme": "paper",
    "defaultRegionColor": "#F1F5F9"
  },
  "locations": [
    {
      "title": "Austin HQ",
      "lat": 30.2672,
      "lon": -97.7431,
      "color": "#1D4ED8"
    },
    {
      "title": "Denver",
      "lat": 39.7392,
      "lon": -104.9903,
      "labelPosition": "right"
    },
    {
      "title": "Seattle",
      "lat": 47.6062,
      "lon": -122.3321
    }
  ],
  "output": {
    "width": 1400,
    "format": "svg"
  }
}

curl https://api.ultimaps.com/v1/renders \
  -H "Content-Type: application/json" \
  -d '{
    "mapId": "united-states",
    "style": {
      "theme": "paper",
      "defaultRegionColor": "#F1F5F9"
    },
    "locations": [
      {
        "title": "Austin HQ",
        "lat": 30.2672,
        "lon": -97.7431,
        "color": "#1D4ED8"
      },
      {
        "title": "Denver",
        "lat": 39.7392,
        "lon": -104.9903,
        "labelPosition": "right"
      },
      {
        "title": "Seattle",
        "lat": 47.6062,
        "lon": -122.3321
      }
    ],
    "output": {
      "width": 1400,
      "format": "svg"
    }
  }' \
  -o map.svg

Map of the United States on a pale theme with labeled pins on Austin, Denver and Seattle, the Austin pin in blue and the other two in the default red

PNG के रूप में दिखाया गया — अनुरोध SVG माँगता है। दोनों तरह से वही मैप।

प्रत्येक पिन अपना रंग, लेबल पक्ष और लेबल दृश्यता लेता है।
पिन निर्देशांक द्वारा रखे जाते हैं। API पतों को जियोकोड नहीं करता।

SVG के लिए Pro कुंजी चाहिए। बिना-कुंजी GET पथ केवल PNG लौटाता है।

रेंडर करने से पहले अनुरोध जाँचें

ड्राई रन इमेज के बजाय JSON लौटाता है: आपकी कौन-सी कुंजियाँ मेल खाईं, कौन-सी नहीं, क्या सुधारा गया और ब्रेक क्या निकले। यह कोई कोटा नहीं लेता।

{
  "mapId": "united-states",
  "choropleth": {
    "values": {
      "Calfornia": 39.5,
      "Texas": 30.5,
      "Florida": 22.6,
      "Atlantis": 1
    }
  },
  "dryRun": true
}

curl https://api.ultimaps.com/v1/renders \
  -H "Content-Type: application/json" \
  -d '{
    "mapId": "united-states",
    "choropleth": {
      "values": {
        "Calfornia": 39.5,
        "Texas": 30.5,
        "Florida": 22.6,
        "Atlantis": 1
      }
    },
    "dryRun": true
  }'

टाइपो "Calfornia" सुधरकर California लौटता है। "Atlantis" बिना मेल के लौटता है।
इसे अपना डेटा जोड़ते समय उपयोग करें, फिर "dryRun" बंद कर दें।

इसके द्वारा लौटाया गया ड्राई-रन JSON खोलें

अनुमान लगाने के बजाय गलत कुंजियों पर विफल हों

डिफ़ॉल्ट रूप से बिना मेल वाली कुंजियाँ छोड़ दी जाती हैं। "onUnmatched" को "error" पर सेट करें और API प्रति-कुंजी सुझावों के साथ 400 लौटाता है, जो किसी शेड्यूल्ड जॉब में आपको चाहिए।

{
  "mapId": "united-states",
  "choropleth": {
    "values": {
      "California": 39.5,
      "Texassss": 30.5,
      "Atlantis": 1
    }
  },
  "onUnmatched": "error"
}

curl https://api.ultimaps.com/v1/renders \
  -H "Content-Type: application/json" \
  -d '{
    "mapId": "united-states",
    "choropleth": {
      "values": {
        "California": 39.5,
        "Texassss": 30.5,
        "Atlantis": 1
      }
    },
    "onUnmatched": "error"
  }' \
  -o map.png

400 एक RFC 9457 समस्या दस्तावेज़ है। संदेश पर नहीं, "code" पर शाखा करें।

इसके द्वारा लौटाया गया 400 खोलें

पूर्ण फ़ील्ड संदर्भ, सभी 26 पैलेट, चार ब्रेक विधियाँ, थीम, अतिरिक्त परतें और संख्या फ़ॉर्मेटिंग सहित: API संदर्भ।

मैप जिन्हें आप रेंडर कर सकते हैं

189 मैप, विश्व और महाद्वीप मैप से लेकर अमेरिकी काउंटी और ZIP कोड क्षेत्रों तक। mapId इस साइट पर मैप का स्लग है, और एक बार प्रकाशित होने के बाद यह कभी नहीं बदलता।

canada europe france-departments india world united-arab-emirates united-kingdom-counties united-states-canada united-states

कुंजियाँ और सीमाएँ

एक कुंजी दर सीमाएँ और कैनवास आकार बढ़ाती है। एक Pro कुंजी वॉटरमार्क हटाती है और SVG अनलॉक करती है। Studio में Workspace के अंतर्गत, फिर API में एक बनाएँ। कुंजियाँ एक बार दिखाई जाती हैं।

curl https://api.ultimaps.com/v1/renders \
  -H "Authorization: Bearer $ULTIMAPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mapId": "united-states",
    "choropleth": {
      "values": {
        "California": 39.5,
        "Texas": 30.5,
        "Florida": 22.6,
        "New York": 19.6,
        "Pennsylvania": 13,
        "Illinois": 12.5,
        "Ohio": 11.8,
        "Georgia": 11,
        "North Carolina": 10.8,
        "Michigan": 10
      },
      "type": "groups",
      "palette": "blues",
      "classes": 5,
      "method": "quantile",
      "noDataColor": "#EEEEEE",
      "noData": true,
      "format": {
        "decimals": 1,
        "suffix": "M"
      }
    },
    "legend": {
      "position": "left",
      "title": "Population (millions)"
    },
    "title": {
      "text": "Population by state, 2025"
    },
    "style": {
      "labels": {
        "show": true,
        "content": "value"
      }
    },
    "output": {
      "width": 1600,
      "scale": 1
    }
  }' \
  -o map.png

टियर	प्रमाणीकरण	फ़ॉर्मेट	एट्रिब्यूशन	कैनवास	दर सीमा	मासिक
बिना-कुंजी	कोई नहीं	PNG	पूर्ण वॉटरमार्क	≤ 1600 px, स्केल 1	30/घंटा प्रति IP, बर्स्ट 5/मिनट	कोई मासिक सीमा नहीं
मुफ़्त कुंजी	Bearer um_live_…	PNG	पूर्ण वॉटरमार्क	≤ 1600 px, स्केल ≤ 2	10/मिनट, 50/दिन	500 रेंडर
Pro कुंजी	Bearer um_live_…	PNG, SVG	कोई नहीं	≤ 4000 px, स्केल ≤ 4	30/मिनट, 1,000/दिन	5,000 रेंडर

मासिक कोटा एक बिलिंग स्थिति है और 402 लौटाता है, कभी पुनःप्रयास योग्य नहीं। दर और समवर्ती सीमाएँ Retry-After के साथ 429 लौटाती हैं। ड्राई रन कभी कोटा नहीं लेते। आप कहाँ खड़े हैं यह जानने के लिए GET /v1/usage देखें।

ChatGPT, Claude या किसी भी MCP क्लाइंट से

इस API का उपयोग ChatGPT, Claude, Cursor या किसी भी MCP क्लाइंट से करें और मैप चैट में वापस पाएँ। https://api.ultimaps.com/mcp को URL द्वारा जोड़ें, या अपने कंप्यूटर पर @ultimaps/mcp पैकेज चलाएँ। किसी को भी खाते की आवश्यकता नहीं।

Ultimaps MCP सर्वर सेट अप करें

v1 में नहीं

v1 इमेज रेंडर करता है। यह इनमें से कुछ नहीं करता:

इंटरैक्टिव या एम्बेड करने योग्य मैप प्रकाशित करना
PDF आउटपुट
पतों को निर्देशांक में जियोकोड करना
किसी मैप के पीछे की ज्यामिति वापस पढ़ना

यदि आपको इनमें से कोई चाहिए, तो हमें बताएँ कौन-सा और जब यह मौजूद होगा तो हम आपको बताएँगे। लोग यहाँ जो माँगते हैं, हम आगे वही बनाते हैं।

संदर्भ

API संदर्भ

हर एंडपॉइंट और फ़ील्ड, चालू API के विरुद्ध लाइव।

त्रुटि कोड

हर कोड, उसकी HTTP स्थिति, और क्या इसे पुनःप्रयास करना है।

openapi.json

OpenAPI 3.1 अनुबंध। इससे एक क्लाइंट जनरेट करें।

llms-full.txt

कोडिंग एजेंट के लिए पूरी API एक सादे-पाठ फ़ाइल के रूप में।

MCP सर्वर

https://api.ultimaps.com/mcp को URL द्वारा जोड़ें, या @ultimaps/mcp स्थानीय रूप से चलाएँ। कोई खाता आवश्यक नहीं।

अक्सर पूछे जाने वाले प्रश्न

क्या कोरोप्लेथ API है?

हाँ, यही इस API का मुख्य काम है। क्षेत्र कुंजियों और संख्याओं का एक सेट पोस्ट करें और आपको एक वर्गीकृत, रंगीन, लेजेंड वाला मैप PNG के रूप में वापस मिलता है। API आपके डेटा से ब्रेक विधि, वर्ग संख्या और पैलेट चुनता है जब तक आप उन्हें स्वयं सेट न करें।

मैं URL से मैप इमेज कैसे जनरेट करूँ?

अपने अनुरोध JSON को GET /v1/renders के spec क्वेरी पैरामीटर में डालें और प्रतिक्रिया स्वयं PNG है। वह URL img टैग, markdown इमेज, Notion इमेज ब्लॉक या Google Sheets IMAGE() फ़ॉर्मूला में काम करता है, बिना कुंजी और बिना खाते के।

क्या मैं बिना API कुंजी के मैप इमेज API का उपयोग कर सकता हूँ?

हाँ। बिना-कुंजी टियर 1600 गुणा 1600 पिक्सेल तक PNG रेंडर करता है, प्रति IP प्रति घंटा 30 रेंडर पर, Ultimaps वॉटरमार्क के साथ। एक कुंजी सीमाएँ बढ़ाती है, और एक Pro कुंजी वॉटरमार्क हटाती है और SVG जोड़ती है।

क्या यह काउंटी मैप API है? क्या मैं इससे काउंटी सीमाएँ प्राप्त कर सकता हूँ?

यह काउंटी मैप को इमेज के रूप में रेंडर करता है, जिसमें सभी 3,143 अमेरिकी काउंटियाँ शामिल हैं, लेकिन यह सीमा ज्यामिति प्रदान नहीं करता। यदि आपको स्वयं प्रोसेस करने के लिए GeoJSON या shapefiles चाहिए, तो इसके बजाय Census TIGER या Natural Earth का उपयोग करें। यह API चित्र लौटाता है।

क्या यह पतों को जियोकोड करता है?

नहीं। पिन अक्षांश और देशांतर द्वारा रखे जाते हैं, और क्षेत्र रंग क्षेत्र कुंजी या नाम द्वारा मिलाए जाते हैं। जियोकोडिंग एक Studio सुविधा है, API सुविधा नहीं।

क्या कोई MCP सर्वर है?

हाँ। ChatGPT, Claude या किसी भी MCP क्लाइंट में https://api.ultimaps.com/mcp को URL द्वारा जोड़ें, या @ultimaps/mcp पैकेज स्थानीय रूप से चलाएँ, और आपके सहायक को बिना किसी खाते के render_map, list_maps और get_map_regions मिलते हैं। प्रत्येक क्लाइंट के लिए सेटअप चरण ultimaps.com/mcp/ पर हैं।

क्या मुझे PNG के बजाय SVG मिल सकता है?

हाँ, Pro कुंजी के साथ। output.format को svg पर सेट करें। बिना-कुंजी और मुफ़्त कुंजियाँ PNG लौटाती हैं।

क्या होता है यदि मेरे क्षेत्र नाम मेल नहीं खाते?

कुंजियाँ क्षेत्र कोड, शीर्षक, सामान्य उपनाम और सामान्यीकृत शीर्षक के विरुद्ध केस-असंवेदनशील रूप से मिलाई जाती हैं, इसलिए US-CA, California और CA सभी एक ही क्षेत्र तक पहुँचते हैं, और अस्पष्ट टाइपो सुधारे और रिपोर्ट किए जाते हैं। डिफ़ॉल्ट रूप से बिना मेल वाली कुंजियाँ छोड़ दी जाती हैं और प्रतिक्रिया हेडर में रिपोर्ट की जाती हैं। onUnmatched को error पर सेट करें और अनुरोध प्रति-कुंजी सुझावों के साथ विफल हो जाता है।

मैं GitHub README में मैप कैसे डालूँ?

बिना-कुंजी GET URL को markdown इमेज के रूप में उपयोग करें। GitHub इसे Camo के माध्यम से प्रॉक्सी करता है, और चूँकि API 24 घंटे का कैश हेडर भेजता है, इमेज रोज़ाना रीफ़्रेश होती है बजाय जमने के।

क्या मैं सर्वर साइड मैप रेंडर कर सकता हूँ?

हाँ। हर रेंडर हमारे सर्वर पर होता है, इसलिए आपके स्टैक में कोई ब्राउज़र, कोई हेडलेस Chrome और कोई मैप लाइब्रेरी नहीं। एक एकल HTTP कॉल तैयार इमेज लौटाता है।