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

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

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

หมายเหตุ: คุณต้องใช้โทเค็นเซสชันเพื่อรับการ์ด 2 มิติและการ์ด Street View แต่ไม่ใช่การรับชิ้นส่วน 3 มิติ

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

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