แผนกลยุทธ์

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

ภาพรวมการ์ดแผนงานการ์ดแผนที่ถนนคือการ์ดรูปภาพที่อิงตามข้อมูลภูมิประเทศแบบเวกเตอร์ ที่มีการจัดรูปแบบแผนที่ของ Google ซึ่งรวมถึงถนน อาคาร จุดที่น่าสนใจ และขอบเขตการปกครอง

การรับการ์ดแผนที่ถนน

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

ตัวอย่างโค้ดต่อไปนี้แสดงคำขอโทเค็นของเซสชันทั่วไปสำหรับการ์ดแผนที่ถนน

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

คุณจะได้รับการ์ดแผนที่ถนนโดยส่งคำขอ GET ของ HTTPS ดังที่แสดงในตัวอย่างต่อไปนี้

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

ในคำขอ HTTPS GET นี้ z คือระดับการซูม (ตั้งแต่ 0 ถึง 22) และ x กับ y คือ พิกัดแผนที่ย่อย ของแผนที่ย่อยที่คุณต้องการดึงข้อมูล

พารามิเตอร์ orientation จะใส่หรือไม่ใส่ก็ได้ ค่าของพารามิเตอร์นี้จะระบุจำนวนองศาของการหมุนทวนเข็มนาฬิกาของรูปภาพการ์ด orientation รองรับสำหรับไทล์ roadmap และยังรองรับคำขอภาพถ่ายจากดาวเทียมและภูมิประเทศโดยนำภาพพื้นฐานออกโดยใช้ "overlay": true และตั้งค่า layerTypes ค่า orientation ที่ใช้ได้คือ 0 (ค่าเริ่มต้น), 90, 180 และ 270

กริดพิกัดการ์ดจะไม่หมุนหากคุณใส่ค่า orientation เช่น หากคุณตั้งค่า orientation เป็น 90 พิกัด x จะยังคงกำหนดตำแหน่งจากซ้ายไปขวาของการ์ด ซึ่งในกรณีนี้คือจากเหนือลงใต้บนแผนที่

การวางแนว 0 องศา การวางแนว 90 องศา
การวางแนว 0 องศา การวางแนว 90 องศา

ตัวอย่างคำขอการ์ด

ลองดูตัวอย่างต่อไปนี้ ซึ่งขอการ์ดเดียวที่มีทั้งโลก ในตัวอย่างนี้ ระดับการซูมคือ 0 และพิกัด x กับ y คือ 0, 0

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

ในตัวอย่างนี้ไม่มีข้อความตอบกลับจากเซิร์ฟเวอร์ แต่การ์ดจะดาวน์โหลดลงในไฟล์ในเครื่องพร้อมสถิติต่อไปนี้

ทั้งโลกในไทล์เดียว

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

ดูข้อมูลเกี่ยวกับส่วนหัวของข้อความตอบกลับได้ที่ การดึงข้อมูลล่วงหน้า การแคช หรือการจัดเก็บเนื้อหา