ใช้โทเค็นเซสชันกับ Map Tiles API

โทเค็นเซสชันคือข้อมูล (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 ที่ 2 เท่าหรือ 4 เท่าเท่านั้น โดยไม่มีผลต่อ ปรับขนาดได้ 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