โทเค็นเซสชันคือชิ้นส่วนของข้อมูล (UUID) ที่ใช้ในการเรียก REST เพื่อระบุเซสชัน ซึ่งเป็นชุดการแลกเปลี่ยนข้อความที่เกี่ยวข้อง คุณต้องรวมโทเค็นเซสชันใน
คำขอทั้งหมดสำหรับการ์ด 2 มิติและภาพ Street View
คุณใส่ค่าดังกล่าวเป็นค่าพารามิเตอร์ session
ต่อท้าย URL คำขอทั้งหมด
ใน Map Tiles API โทเค็นเซสชันจะแสดงชุดตัวเลือกการแสดงผลที่กำหนดไว้ ซึ่งหมายความว่าคุณไม่ต้องส่งชุดตัวเลือกการแสดงผลพร้อมคำขอการ์ดแต่ละรายการ โดยใช้โทเค็นเซสชันเดียวกันในหลายๆ ไคลเอ็นต์ได้
ปัจจุบันโทเค็นเซสชันมีอายุ 2 สัปดาห์นับจากวันที่เกิดปัญหา แต่อาจมีการเปลี่ยนแปลงได้ คุณตรวจสอบเวลาหมดอายุของโทเค็นเซสชันได้ทุกเมื่อโดยดูที่ช่อง expiry
ในข้อความตอบกลับ
คำขอโทเค็นของเซสชัน
หากต้องการขอโทเค็นเซสชัน ให้ส่งคำขอ HTTPS POST ไปยังปลายทาง createSession
ดังที่แสดงในตัวอย่างต่อไปนี้ คุณต้องส่งคำขอที่มีส่วนหัว Content-Type: application/json
curl -X POST -d '{ "mapType": "streetview", "language": "en-US", "region": "US" }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"
ฟิลด์ที่จำเป็น
mapType
ประเภทของแผนที่ฐาน ค่านี้อาจเป็นค่าใดค่าหนึ่งต่อไปนี้
roadmap
- ชิ้นส่วนแผนที่แบบมาตรฐานของ Google Maps
satellite
- ภาพจากดาวเทียม
terrain
- ภาพภูมิประเทศ เมื่อเลือก
terrain
เป็นประเภทแผนที่ คุณต้องรวมประเภทเลเยอร์layerRoadmap
ไว้ด้วย (อธิบายไว้ในส่วนช่องที่ไม่บังคับ) streetview
- พาโนรามา Street View สำหรับข้อมูลเพิ่มเติม โปรดดู การ์ด Street View
language
แท็กภาษา IETF ที่ระบุภาษาที่ใช้ในการแสดงข้อมูลในชิ้นส่วน ตัวอย่างเช่น
en-US
จะระบุภาษาอังกฤษตามที่พูดในสหรัฐอเมริกาregion
ตัวระบุภูมิภาคที่เก็บข้อมูลภาษาทั่วไป (อักษรตัวพิมพ์ใหญ่ 2 ตัว) ที่แสดงสถานที่ตั้งจริงของผู้ใช้ เช่น
US
ช่องที่ไม่บังคับ
imageFormat
- ระบุรูปแบบไฟล์ที่จะแสดงผล ค่าที่ถูกต้องคือ
jpeg
หรือpng
ไฟล์ JPEG ไม่สนับสนุนความโปร่งใส จึงไม่แนะนำให้ใช้กับการ์ดการวางซ้อน หากไม่ระบุimageFormat
ระบบจะเลือกรูปแบบที่ดีที่สุดสำหรับการ์ดให้โดยอัตโนมัติ scale
ขยายขนาดขององค์ประกอบแผนที่ (เช่น ป้ายกำกับถนน) ขณะเดียวกันก็ยังคงขนาดชิ้นส่วนแผนที่และพื้นที่ครอบคลุมของชิ้นส่วนแผนที่เริ่มต้นไว้ การเพิ่มขนาดยังจะลดจำนวนป้ายกำกับบนแผนที่ ซึ่งช่วยลดความยุ่งเหยิง ค่าต่อไปนี้เป็นค่า
scale
ที่ถูกต้องscaleFactor1x
: ค่าเริ่มต้นscaleFactor2x
: เพิ่มขนาดป้ายกำกับเป็น 2 และนำป้ายกำกับฟีเจอร์ย่อยออกscaleFactor4x
: ขนาดป้ายกำกับเป็น 4 ส่วนและนำป้ายกำกับฟีเจอร์ย่อยออก
ตัวอย่างต่อไปนี้แสดงผลกระทบของการปรับขนาดองค์ประกอบแผนที่
ปัจจัยสเกล 1x | ปัจจัยสเกล 2 เท่า |
---|---|
highDpi
- ระบุว่าจะแสดงไทล์ความละเอียดสูงหรือไม่ หากตัวคูณมาตราส่วนเพิ่มขึ้น ระบบจะใช้
highDpi
เพื่อเพิ่มขนาดของการ์ด โดยปกติแล้ว การเพิ่มตัวคูณมาตราส่วนจะขยายชิ้นส่วนที่ได้ให้เป็นรูปภาพที่มีขนาดเท่ากัน ซึ่งจะทำให้คุณภาพลดลง เมื่อใช้highDpi
ขนาดผลลัพธ์ก็จะเพิ่มขึ้นด้วยเพื่อรักษาคุณภาพไว้ DPI ย่อมาจาก Dots per Inch และ High DPI หมายความว่าชิ้นส่วนแสดงผลโดยใช้จุดต่อนิ้วมากกว่าปกติ หากเป็นtrue
จำนวนพิกเซลในแต่ละด้านของขนาด x และ y จะคูณด้วยตัวประกอบการปรับขนาด (ซึ่งก็คือ 2x หรือ 4x) พื้นที่ความครอบคลุมของไทล์จะไม่เปลี่ยนแปลง พารามิเตอร์นี้ใช้ได้กับค่าscale
ที่ 2x หรือ 4x เท่านั้น ซึ่งจะไม่มีผลต่อชิ้นส่วน ขนาด 1 เท่า
ปัจจัยสเกล 1x | ปัจจัยสเกล 2x DPI สูง |
---|---|
layerTypes
อาร์เรย์ของค่าที่ระบุประเภทเลเยอร์ที่เพิ่มลงในแผนที่ ค่าที่ใช้ได้มีดังนี้
layerRoadmap
- ต้องระบุหากคุณระบุ
terrain
เป็นประเภทแผนที่ และยังเลือกวางซ้อนบนแผนที่ประเภทsatellite
ได้ด้วย ไม่มีผลต่อชิ้นส่วนแผนกลยุทธ์ layerStreetview
- แสดงถนนและสถานที่ที่เปิดใช้ Street View โดยใช้เส้นกรอบสีน้ำเงินบนแผนที่
layerTraffic
- แสดงสภาพการจราจรปัจจุบัน
styles
อาร์เรย์ของออบเจ็กต์รูปแบบ JSON ที่ระบุลักษณะและระดับรายละเอียดของฟีเจอร์ในแผนที่ เช่น ถนน สวนสาธารณะ และพื้นที่ที่สร้างขึ้น การจัดรูปแบบใช้สำหรับปรับแต่ง แผนที่ฐานมาตรฐานของ Google พารามิเตอร์
styles
จะใช้ได้ก็ต่อเมื่อประเภทแผนที่คือroadmap
ดูไวยากรณ์ของสไตล์ทั้งหมดได้ที่การอ้างอิงรูปแบบoverlay
ค่าบูลีนที่ระบุว่าควรแสดงผล
layerTypes
เป็นการวางซ้อนแยกต่างหากหรือรวมกับภาพฐาน เมื่อtrue
แผนที่ฐานจะไม่ปรากฏ หากยังไม่ได้กำหนดlayerTypes
ระบบจะละเว้นค่านี้
ตัวอย่างเช่น การขอประเภทแผนที่ satellite
ที่มีเลเยอร์ layerRoadmap
และกำหนดให้ overlay
เป็น false
จะทำให้ได้ชิ้นส่วนแผนที่เทียบเท่ากับแผนที่ hybrid
ประเภทที่ใช้ใน Maps JavaScript API (ภาพซ้ายมือ) แผนที่และเลเยอร์ประเภทเดียวกันที่ตั้งค่า overlay
เป็น true
จะทำให้แผนที่โปร่งใสพร้อมการวางซ้อนแผนที่ ซึ่งจัดรูปแบบอย่างเหมาะสมสำหรับวางซ้อนบนภาพถ่ายจากดาวเทียม (ภาพด้านขวา)
overlay : เท็จ |
overlay : จริง |
---|---|
JSON ต่อไปนี้เป็นตัวอย่างของเนื้อหาคำขอทั่วไปที่มีทั้งฟิลด์ที่จำเป็นและฟิลด์ที่ไม่บังคับ
{
"mapType": "satellite",
"language": "en-US",
"region": "us",
"layerTypes": [ "layerRoadmap", "layerStreetview" ],
"overlay": true,
"scale": "scaleFactor1x",
"styles": [
{
"stylers": [
{ "hue": "#00ffe6" },
{ "saturation": -20 }
]
},{
"featureType": "road",
"elementType": "geometry",
"stylers": [
{ "lightness": 100 },
{ "visibility": "simplified" }
]
}
]
}
ตัวอย่างนี้แสดงภาพซ้อนทับที่เหมาะสำหรับการรวมกับภาพถ่ายจากดาวเทียม ตัวอย่างนี้มีทั้งแผนกลยุทธ์และการวางซ้อนมุมมองถนน แผนที่ผลลัพธ์จะแสดงชื่อและข้อมูลเป็นภาษาอังกฤษ ตามที่พูดในสหรัฐอเมริกา
apiOptions
: อาร์เรย์ของค่าที่ระบุตัวเลือกเพิ่มเติมที่จะนำไปใช้
ตัวเลือกที่รองรับมีดังนี้
MCYJ5E517XR2JC
- เลือกใช้แผนที่รูปแบบใหม่ ในช่วงการเลือกใช้ คำขอของคุณจะได้รับสไตล์ที่มีอยู่ เว้นแต่จะมีการระบุค่านี้
การตอบกลับของโทเค็นเซสชัน
JSON ต่อไปนี้เป็นตัวอย่างเนื้อหาการตอบสนอง
{
"session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
"expiry": "1361828036",
"tileWidth": 256,
"tileHeight": 256,
"imageFormat": "png"
}
รายการต่อไปนี้มีคำจำกัดความของช่องในเนื้อหาการตอบกลับ
session
- ค่าโทเค็นเซสชันที่คุณต้องรวมไว้ในคำขอ Map Tiles API ทั้งหมด
expiry
- สตริงที่มีเวลา (เป็นวินาทีหลังจาก Epoch) ที่โทเค็นหมดอายุ โทเค็นเซสชันมีอายุ 2 สัปดาห์นับจากเวลาที่สร้าง แต่นโยบายนี้อาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบ
tileWidth
- ความกว้างของชิ้นส่วนที่วัดเป็นพิกเซล
tileHeight
- ความสูงของชิ้นส่วนที่วัดเป็นพิกเซล
imageFormat
- รูปแบบรูปภาพ ซึ่งจะเป็น
png
หรือjpeg
ก็ได้