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

โทเค็นเซสชันคือข้อมูล (UUID) ที่ใช้ในการเรียก REST เพื่อระบุเซสชัน ซึ่งเป็นชุดการแลกเปลี่ยนข้อความที่เกี่ยวข้อง คุณต้องใส่โทเค็นเซสชันในคำขอไทล์ 2 มิติและภาพ Street View ทั้งหมด คุณสามารถใส่ค่านี้ไว้ที่พารามิเตอร์ session ต่อท้าย URL คำขอทั้งหมด

ใน Map Tiles API โทเค็นเซสชันแสดงถึงชุดตัวเลือกการแสดงผลที่กําหนดไว้ ซึ่งหมายความว่าคุณไม่จําเป็นต้องส่งชุดตัวเลือกการแสดงผลพร้อมกับคําขอแต่ละรายการ คุณใช้โทเค็นเซสชันเดียวกันกับไคลเอ็นต์หลายรายการได้ ปัจจุบันโทเค็นเซสชันจะใช้งานได้เป็นเวลา 2 สัปดาห์นับจากเวลาที่ออก แต่ข้อมูลนี้อาจเปลี่ยนแปลงได้ คุณสามารถตรวจสอบเวลาหมดอายุของโทเค็นเซสชันได้ทุกเมื่อโดยดูที่ช่อง expiry ในข้อความตอบกลับ

คำขอโทเค็นเซสชัน

หากต้องการขอโทเค็นเซสชัน ให้ส่งคำขอ POST ผ่าน HTTPS ไปยังปลายทาง 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

ระบุว่าจะแสดงผลการ์ดภาพความละเอียดสูงหรือไม่ หากเพิ่ม scale-factor ระบบจะใช้ highDpi เพื่อเพิ่มขนาดของการ์ด โดยทั่วไปแล้ว การเพิ่มตัวคูณขนาดจะขยายไทล์ที่ได้ให้กลายเป็นรูปภาพขนาดเท่าเดิม ซึ่งจะทำให้คุณภาพลดลง เมื่อใช้ highDpi ขนาดของไฟล์ที่ออกมาจะเพิ่มขึ้นด้วยเพื่อรักษาคุณภาพ DPI ย่อมาจาก Dots per Inch และ DPI สูงหมายความว่าการ์ดแสดงผลจะแสดงผลโดยใช้จุดต่อนิ้วมากกว่าปกติ หากเป็น true ระบบจะคูณจํานวนพิกเซลในแต่ละมิติข้อมูล x และ y ด้วยปัจจัยการขยาย (นั่นคือ 2 เท่าหรือ 4 เท่า) พื้นที่ครอบคลุมของชิ้นส่วนแผนที่จะยังคงเหมือนเดิม พารามิเตอร์นี้ใช้ได้กับค่า scale ที่ 2 เท่าหรือ 4 เท่าเท่านั้น แต่จะไม่มีผลกับการ์ดขนาด 1x

อัตราส่วนการขยาย 1x	ปัจจัยการขยายขนาด 2x High 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: false	overlay: true

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" }
      ]
    }
  ]
}

ตัวอย่างนี้แสดงการวางซ้อนที่เหมาะสำหรับการรวมกับภาพถ่ายดาวเทียม ตัวอย่างนี้มีทั้งแผนภาพและภาพ Street View ที่วางซ้อนกัน แผนที่ที่ได้จะแสดงผลพร้อมชื่อและข้อมูลเป็นภาษาอังกฤษตามที่ใช้กันในสหรัฐอเมริกา

apiOptions: อาร์เรย์ของค่าที่ระบุตัวเลือกเพิ่มเติมที่จะใช้ ตัวเลือกที่รองรับ ได้แก่

• MCYJ5E517XR2JC - เลือกใช้รูปแบบแผนที่ใหม่ ในระหว่างระยะเวลาเลือกใช้ คำขอของคุณจะได้รับรูปแบบที่มีอยู่ เว้นแต่จะมีการระบุค่านี้

การตอบกลับโทเค็นเซสชัน

JSON ต่อไปนี้คือตัวอย่างเนื้อหาคำตอบ

{
  "session": "IgAAAHGU9jnAU4KOAfwY3Bcd6eH_WxQsyocSBAdUnAr9pnvTTNXtF9c_27RBo94ytEXTDg",
  "expiry": "1361828036",
  "tileWidth": 256,
  "tileHeight": 256,
  "imageFormat": "png"
}

รายการต่อไปนี้มีคำจำกัดความของช่องในเนื้อหาการตอบกลับ

session

ค่าโทเค็นเซสชันที่คุณต้องใส่ไว้ในคําขอ Map Tiles API ทั้งหมด

expiry

สตริงที่มีเวลา (เป็นวินาทีนับจากจุดเริ่มต้น) ที่โทเค็นจะหมดอายุ โทเค็นเซสชันจะใช้งานได้ 2 สัปดาห์นับจากเวลาที่สร้างขึ้น แต่นโยบายนี้อาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบ

tileWidth

ความกว้างของไทล์ที่วัดเป็นพิกเซล

tileHeight

ความสูงของไทล์ที่วัดเป็นพิกเซล

imageFormat

รูปแบบรูปภาพ ซึ่งอาจเป็น png หรือ jpeg