ใช้โทเค็นเซสชันกับ 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 เท่าและนำป้ายกำกับองค์ประกอบรองออก

ตัวอย่างต่อไปนี้แสดงผลกระทบของการปรับขนาดองค์ประกอบแผนที่

อัตราส่วนการปรับขนาด 1 เท่า	อัตราส่วนการขยาย 2 เท่า

highDpi

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

ปัจจัยสเกล 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: 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

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

tileWidth

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

tileHeight

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

imageFormat

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