เอกสาร / การตั้งค่า

การตั้งค่า แยกตามผู้ให้บริการ

MapConductor ไม่ได้มาแทน SDK แผนที่ แต่วาง API ร่วมไว้ด้านบน โค้ดที่ใช้วาดแผนที่เหมือนกัน ทว่าขั้นตอนนำ SDK แต่ละตัวเข้าโปรเจกต์ ทั้งการขอคีย์ การเพิ่ม dependency และวิธี initialize ยังต้องทำตามกติกาของผู้ให้บริการนั้น ๆ หน้านี้รวบรวมส่วนนั้นไว้ตามคู่ของแพลตฟอร์มและผู้ให้บริการ

ANDROID
10 providers
IOS
11 providers
REACT (WEB)
14 providers

01 · ตารางการรองรับ

คู่ที่มีคู่มือแล้วในตอนนี้ เครื่องหมาย — หมายความว่าไม่มีโมดูลของผู้ให้บริการนั้นบนแพลตฟอร์มนั้น

Provider
Android
iOS
React (Web)
คีย์
Google Maps
จำเป็น
MapLibre
ไม่จำเป็น
Mapbox
มีเงื่อนไข
HERE
จำเป็น
ArcGIS
จำเป็น
MapTiler
จำเป็น
TomTom
จำเป็น
Longdo
จำเป็น
Apple MapKit
มีเงื่อนไข
Leaflet
ไม่จำเป็น
OpenLayers
ไม่จำเป็น
Azure Maps
จำเป็น
Cesium
ไม่จำเป็น
Mappls
จำเป็น
Open Mobile Maps
ไม่จำเป็น

React Native รองรับ Google Maps, MapLibre, ArcGIS และ HERE โดยใช้อ็อบเจกต์สถานะและคอมโพเนนต์ชุดเดียวกับเว็บ จึงไม่มีหน้าตั้งค่าแยก แต่กล่าวถึงไว้ในคู่มือ React แต่ละหน้า

02 · การเลือกผู้ให้บริการ

หากยังลังเล วิธีที่เร็วที่สุดคือเริ่มกับผู้ให้บริการที่ไม่ต้องใช้คีย์ให้ทำงานได้ก่อน แล้วค่อยสลับทีหลัง ตราบใดที่เขียนด้วย API ร่วม แทบไม่มีงานส่วนใดสูญไปกับการสลับ

Google Maps
ตัวเลือกมาตรฐานที่ใช้ได้ครบทั้งสามแพลตฟอร์ม ต้องใช้คีย์ API ของ Google Cloud
MapLibre
เอนจินเรนเดอร์โอเพนซอร์ส ไม่ต้องใช้คีย์ เพียงเลือกแหล่งไทล์
Mapbox
ต้องใช้ access token เฉพาะเมื่อใช้สไตล์ที่โฮสต์บน Mapbox
HERE
มีสไตล์สำหรับงานโลจิสติกส์และการนำทางครบครัน ใช้ Access Key ID และ Secret
ArcGIS
ใช้ข้อมูล GIS ที่มีอยู่ได้ทันที มีทั้งมุมมองแบบ 2 มิติและ 3 มิติ
MapTiler
เลือกสไตล์อ้างอิงของ MapTiler Cloud ได้ 16 แบบตามชื่อ
TomTom
TomTom Orbis Maps พร้อมสไตล์สำหรับการขับขี่
Longdo
แผนที่ที่เน้นพื้นที่ประเทศไทย ห่อหุ้ม Longdo Map API3 ไว้
Apple MapKit
บน iOS มีมากับระบบและไม่ต้องใช้คีย์ ส่วน MapKit JS บนเว็บต้องใช้โทเคน JWT
Leaflet
เฉพาะเว็บ เหมาะกับการแสดงไทล์แบบราสเตอร์ที่ต้องการความเบา
OpenLayers
เฉพาะเว็บ เลือกใช้เมื่อต้องจัดการเรื่องการฉายภาพอย่างเคร่งครัด
Azure Maps
เฉพาะเว็บ ใช้คีย์การสมัครใช้งานของ Azure
Cesium
เฉพาะเว็บ สำหรับงานที่ต้องแสดงลูกโลกแบบ 3 มิติจริง ๆ
Mappls
Mappls (MapmyIndia) เด่นเรื่องที่อยู่และ POI ในประเทศอินเดีย
Open Mobile Maps
เอนจินเรนเดอร์โอเพนซอร์ส ไม่ต้องใช้คีย์ และเตรียมสไตล์เอง

03 · คู่มือทุกหน้าเรียงเหมือนกัน

ทุกหน้าเรียงลำดับเหมือนกัน เวลาย้ายผู้ให้บริการจึงอ่านเฉพาะส่วนที่ต่างก็พอ

1 · ข้อมูลรับรอง
ขอคีย์หรือโทเคนได้จากที่ไหน และจำกัดการใช้งานอย่างไร
2 · ดีเพนเดนซี
ต้องเพิ่มรีโพซิทอรีใด และระบุโมดูลใดบ้าง
3 · การเริ่มต้นใช้งาน
วิธีส่งคีย์ให้ SDK ซึ่งเป็นขั้นตอนที่ต่างกันมากที่สุดระหว่างผู้ให้บริการ
4 · ตรวจสอบ
โค้ดขั้นต่ำที่วางแล้วรันได้ พร้อมจุดที่ควรตรวจเมื่อไม่ทำงาน
API KEYS

MapConductor ไม่เก็บคีย์ของคุณ

คีย์ของคุณถูกส่งให้ SDK แผนที่ตามวิธีที่ SDK นั้นกำหนดโดยตรง ไม่ว่าจะเป็นไฟล์ manifest บน Android, closure ตอน initialize บน iOS หรืออ็อบเจกต์สถานะบนเว็บ MapConductor ไม่รับส่งต่อและไม่จัดเก็บคีย์ การจำกัดสิทธิ์และการเพิกถอนคีย์จึงยังทำที่คอนโซลของผู้ให้บริการเหมือนเดิม

หน้าที่เกี่ยวข้อง