โทเค็นเซสชันคือชิ้นส่วนของข้อมูล (
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
CANNOT TRANSLATE แท็กภาษา 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
ก็ได้