Ultimaps MCP

ทางการ

แปลงข้อมูลเป็นภาพแผนที่: แผนที่โคลโรเพลธ แผนที่หมวดหมู่ และแผนที่ปักหมุดของโลก ประเทศ รัฐ เทศมณฑล และรหัสไปรษณีย์

ดูบน ultimaps.comลองใช้ MCP นี้ผู้สนับสนุน

คุณทำอะไรได้บ้างด้วย Ultimaps MCP?

Render custom map images — ขอแผนที่โครเพลธ แผนที่หมวดหมู่ หรือแผนที่พินของประเทศ รัฐ เคาน์ตี หรือพื้นที่รหัสไปรษณีย์ใดๆ แล้วรับไฟล์ PNG กลับมาทันที
Highlight specific regions — ขอแผนที่ที่มีรัฐ เคาน์ตี หรือรหัสไปรษณีย์เฉพาะระบายสีด้วยค่า hex ที่กำหนดเอง พร้อมคีย์ภูมิภาคที่ยืดหยุ่น เช่น "US-CA" หรือ "California"
Create choropleths from raw data — ระบุตัวเลขต่อภูมิภาค แล้ว API จะจัดกลุ่มสีอัตโนมัติพร้อมคำอธิบายlegend จานสี และวิธีการแบ่งช่วงที่คุณเลือก
Add location pins — วางมาร์กเกอร์พร้อมป้ายกำกับตามละติจูดและลองจิจูดบนแผนที่ใดๆ โดยกำหนดสีและตำแหน่งป้ายต่อพินได้
Validate map requests before rendering — ใช้การทดลองรันแบบแห้งเพื่อตรวจสอบว่าคีย์ภูมิภาคใดตรงกัน รับคำแนะนำการแก้ไขคำผิด และดูการแบ่งช่วงคลาสโดยไม่ใช้โควตา
List available maps and regions — สอบถามว่าแผนที่ใดจากทั้งหมด 189 แผนที่ (ตั้งแต่ระดับโลกจนถึงเคาน์ตีของสหรัฐฯ) พร้อมใช้งาน หรือรับรายการภูมิภาคสำหรับแผนที่เฉพาะ

เอกสาร

Map Image API

ข้อมูลเข้า แผนที่ภาพออก หนึ่ง URL เรนเดอร์แผนที่โครเพลธ (choropleth) แผนที่หมวดหมู่ หรือแผนที่พินของประเทศ รัฐ เคาน์ตี หรือพื้นที่รหัสไปรษณีย์ใดๆ เป็นไฟล์ 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 คือ JSON ที่เข้ารหัสแบบ URL และการตอบสนองคือตัวรูปภาพเอง

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 รองรับทุกฟีเจอร์แต่จำกัด spec ที่ 6KB และเรนเดอร์ PNG แบบไม่มีคีย์ได้สูงสุด 1600px เสมอ ส่ง JSON เดียวกันไปที่ POST /v1/renders เพื่อเพย์โหลดที่ใหญ่ขึ้น คีย์สำหรับผืนผ้าใบที่ใหญ่ขึ้น หรือคีย์ Pro สำหรับ SVG

แก้ไขได้ในภายหลัง

รูปภาพทุกภาพมีส่วนหัว 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 labelled with its abbreviation

แผนที่สหรัฐอเมริกาชื่อ "Where we operate" โดยแคลิฟอร์เนียเป็นสีน้ำเงิน เท็กซัสเป็นสีส้ม และนิวยอร์กเป็นสีเขียว ทุกรัฐอื่นใช้ธีมเริ่มต้นและติดป้ายกำกับด้วยตัวย่อ

คีย์ภูมิภาคมีความยืดหยุ่น "US-CA", "California" และ "CA" ทั้งหมดเข้าถึงภูมิภาคเดียวกัน
สีเป็นสตริงเลขฐานสิบหก ภูมิภาคที่คุณละไว้จะคงค่าเริ่มต้นของธีม
"style.labels.show" พิมพ์ชื่อภูมิภาคทั้งหมด ไม่มีวิธีติดป้ายเฉพาะภูมิภาคที่คุณระบายสี

เปิดการเรนเดอร์นี้ในแท็บใหม่

โครเพลธจากตัวเลข

ให้ค่าดิบแก่ 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",
    "format": {
      "decimals": 1,
      "suffix": "M"
    }
  },
  "legend": {
    "position": "left"
  },
  "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",
      "format": {
        "decimals": 1,
        "suffix": "M"
      }
    },
    "legend": {
      "position": "left"
    },
    "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" ระบายสีภูมิภาคที่ข้อมูลของคุณไม่ครอบคลุม
"format" ควบคุมป้ายกำกับจุดแบ่งในคำอธิบายแผนภูมิ ไม่ใช่รูปแบบรูปภาพ

เปิดการเรนเดอร์นี้ในแท็บใหม่

พิน

เครื่องหมายละติจูดและลองจิจูด พินประกอบรวมกับอย่างอื่นได้ ดังนั้นคุณสามารถวางบนแผนที่โครเพลธหรือแผนที่ธรรมดาได้

เอาต์พุต SVG ต้องใช้คีย์ Pro ละเว้น "format" เพื่อใช้ PNG ในทุกระดับ

{
  "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 labelled 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 เท่านั้น

ตรวจสอบคำขอก่อนเรนเดอร์

Dry run ส่งคืน 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 ของ dry-run ที่ส่งคืน

ล้มเหลวกับคีย์ที่ไม่ถูกต้องแทนการเดา

โดยค่าเริ่มต้น คีย์ที่ไม่ตรงจะถูกข้าม ตั้ง "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 แผนที่ ตั้งแต่แผนที่โลกและทวีปไปจนถึงเคาน์ตีสหรัฐฯ และพื้นที่รหัสไปรษณีย์ mapId คือ slug ของแผนที่บนไซต์นี้ และไม่เปลี่ยนแปลงเมื่อเผยแพร่แล้ว

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

คีย์และขีดจำกัด

คีย์เพิ่มอัตราจำกัดและขนาดผืนผ้าใบ คีย์ 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",
      "format": {
        "decimals": 1,
        "suffix": "M"
      }
    },
    "legend": {
      "position": "left"
    },
    "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 ไม่สามารถลองใหม่ได้ ขีดจำกัดอัตราและความพร้อมใช้งานส่งคืน 429 พร้อม Retry-After Dry run ไม่ใช้โควตา ตรวจสอบ GET /v1/usage เพื่อดูสถานะของคุณ

จาก ChatGPT, Claude หรือไคลเอนต์ MCP ใดๆ

ขอแผนที่ในแชทแล้วรับรูปภาพกลับมา เซิร์ฟเวอร์ MCP ให้ API นี้แก่ผู้ช่วยของคุณเป็นสามเครื่องมือ: render_map, list_maps และ get_map_regions คุณไม่จำเป็นต้องมีบัญชี

เพิ่มด้วย URL

ใน ChatGPT (โหมดนักพัฒนา), claude.ai หรือไคลเอนต์ใดๆ ที่เชื่อมต่อกับเซิร์ฟเวอร์ MCP ระยะไกล เพิ่ม https://api.ultimaps.com/mcp ไม่ต้องติดตั้งอะไร ใน ChatGPT เปิดใช้งานในการสนทนาแต่ละครั้งที่คุณต้องการแผนที่

claude mcp add --transport http ultimaps https://api.ultimaps.com/mcp
# with a key:
claude mcp add --transport http ultimaps https://api.ultimaps.com/mcp \
  --header "Authorization: Bearer um_live_…"

ไคลเอนต์ที่มีไฟล์คอนฟิกใช้ URL เพียงอย่างเดียว นี่คือ mcp.json ของ Cursor

{
  "mcpServers": {
    "ultimaps": { "url": "https://api.ultimaps.com/mcp" }
  }
}

หากไคลเอนต์ของคุณส่งส่วนหัวได้ เพิ่ม Authorization: Bearer <key> สำหรับโควตาและเอาต์พุตของแผนของคุณ หากไม่มีคีย์ การเรนเดอร์เป็น PNG สูงสุด 1600 px พร้อมการระบุแหล่งที่มา สูงสุด 30 ต่อชั่วโมงต่อการสนทนา ทุกแผนที่ยังมาพร้อมลิงก์รูปภาพที่หมดอายุหลังจาก 30 วัน และลิงก์นั้นคือวิธีที่คุณเห็นแผนที่ใน ChatGPT

หรือรันบนคอมพิวเตอร์ของคุณ

@ultimaps/mcp รันเครื่องมือเดียวกันในเครื่องผ่าน stdio คำขอมาจากที่อยู่ IP ของคุณเอง และทุกภาพถูกบันทึกเป็นไฟล์ที่คุณเปิดได้

claude mcp add ultimaps -- npx -y @ultimaps/mcp
codex mcp add ultimaps -- npx -y @ultimaps/mcp

ไคลเอนต์ที่อ่านไฟล์คอนฟิกใช้สองค่าเดียวกัน นี่คือ claude_desktop_config.json

{
  "mcpServers": {
    "ultimaps": {
      "command": "npx",
      "args": ["-y", "@ultimaps/mcp"],
      "env": { "ULTIMAPS_API_KEY": "" }
    }
  }
}

ปล่อย ULTIMAPS_API_KEY ว่างสำหรับระดับไม่มีคีย์ ขีดจำกัดเดียวกันกับตารางด้านบน หรือกรอกสำหรับโควตาและเอาต์พุตของแผนของคุณ

ไม่มีใน v1

v1 เรนเดอร์รูปภาพ ไม่ทำสิ่งเหล่านี้:

เผยแพร่แผนที่แบบโต้ตอบหรือฝังได้
เอาต์พุต PDF
แปลงที่อยู่เป็นพิกัด
อ่านกลับเรขาคณิตที่อยู่เบื้องหลังแผนที่

หากคุณต้องการหนึ่งในนี้ บอกเราว่าอันไหน แล้วเราจะแจ้งให้คุณทราบเมื่อมี สิ่งที่ผู้คนขอที่นี่คือสิ่งที่เราสร้างต่อไป

เอกสารอ้างอิง

เอกสารอ้างอิง API

ทุก endpoint และฟิลด์ แบบเรียลไทม์กับ 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 คำขอของคุณในพารามิเตอร์ spec ของ GET /v1/renders แล้วการตอบสนองคือ PNG เอง URL นั้นทำงานในแท็ก img รูปภาพ markdown บล็อกรูปภาพ Notion หรือสูตร IMAGE() ของ Google Sheets โดยไม่มีคีย์และไม่มีบัญชี

ฉันใช้ API รูปภาพแผนที่โดยไม่มีคีย์ API ได้หรือไม่?

ได้ ระดับไม่มีคีย์เรนเดอร์ PNG สูงสุด 1600 x 1600 พิกเซลที่ 30 การเรนเดอร์ต่อชั่วโมงต่อ IP พร้อมลายน้ำ Ultimaps คีย์เพิ่มขีดจำกัด และคีย์ Pro ลบลายน้ำและเพิ่ม SVG

นี่คือ API แผนที่เคาน์ตีหรือไม่? ฉันดึงขอบเขตเคาน์ตีออกมาได้ไหม?

มันเรนเดอร์แผนที่เคาน์ตีเป็นรูปภาพ รวมถึงเคาน์ตีสหรัฐฯ ทั้ง 3,143 แห่ง แต่ไม่ให้บริการเรขาคณิตขอบเขต หากคุณต้องการ GeoJSON หรือ shapefile เพื่อประมวลผลเอง ใช้ Census TIGER หรือ Natural Earth แทน API นี้ส่งคืนรูปภาพ

มันแปลงที่อยู่เป็นพิกัดหรือไม่?

ไม่ พินวางตามละติจูดและลองจิจูด และสีภูมิภาคจับคู่ด้วยคีย์หรือชื่อภูมิภาค การแปลงที่อยู่เป็นพิกัดเป็นฟีเจอร์ของ Studio ไม่ใช่ของ API

มีเซิร์ฟเวอร์ MCP หรือไม่?

มี สองวิธีในการเชื่อมต่อ เพิ่ม https://api.ultimaps.com/mcp ด้วย URL ใน ChatGPT (โหมดนักพัฒนา จากนั้นเปิดในการสนทนาของคุณ), claude.ai หรือไคลเอนต์ใดๆ ที่รองรับเซิร์ฟเวอร์ MCP ระยะไกล หรือติดตั้ง @ultimaps/mcp ซึ่งรันบนคอมพิวเตอร์ของคุณผ่าน stdio ใน Claude Code, Codex, Claude Desktop, Cursor หรือ VS Code ทั้งสองให้ render_map, list_maps และ get_map_regions และไม่ต้องมีบัญชี

ฉันขอ SVG แทน PNG ได้ไหม?

ได้ ด้วยคีย์ Pro ตั้ง output.format เป็น svg คีย์แบบไม่มีคีย์และฟรีส่งคืน PNG

จะเกิดอะไรขึ้นถ้าชื่อภูมิภาคของฉันไม่ตรง?

คีย์จับคู่แบบไม่คำนึงถึงตัวพิมพ์ใหญ่เล็กกับรหัสภูมิภาค ชื่อเรื่อง นามแฝงทั่วไป และชื่อเรื่องที่ทำให้เป็นมาตรฐาน ดังนั้น US-CA, California และ CA ทั้งหมดเข้าถึงภูมิภาคเดียวกัน และคำพิมพ์ผิดที่ชัดเจนถูกแก้ไขและรายงาน โดยค่าเริ่มต้น คีย์ที่ไม่ตรงจะถูกข้ามและรายงานในส่วนหัวการตอบสนอง ตั้ง onUnmatched เป็น error แล้วคำขอจะล้มเหลวพร้อมคำแนะนำรายคีย์แทน

ฉันจะใส่แผนที่ใน GitHub README ได้อย่างไร?

ใช้ URL GET แบบไม่มีคีย์เป็นรูปภาพ markdown GitHub พร็อกซีผ่าน Camo และเนื่องจาก API ส่งส่วนหัวแคช 24 ชั่วโมง รูปภาพจึงรีเฟรชทุกวันแทนที่จะค้าง

ฉันเรนเดอร์แผนที่ฝั่งเซิร์ฟเวอร์ได้ไหม?

ได้ ทุกการเรนเดอร์เกิดขึ้นบนเซิร์ฟเวอร์ของเรา ดังนั้นไม่มีเบราว์เซอร์ ไม่มี headless Chrome และไม่มีไลบรารีแผนที่ในสแตกของคุณ การเรียก HTTP ครั้งเดียวส่งคืนรูปภาพที่เสร็จสมบูรณ์