ภาพ Street View

ตัวอย่าง Street Viewชิ้นส่วนแผนที่ Street View นั้นคล้ายกับชิ้นส่วน 2 มิติ เว้นแต่มีภาพพาโนรามาที่ถ่ายที่ระดับถนน คุณสามารถสำรวจจุดสังเกตทั่วโลก ดูความมหัศจรรย์ทางธรรมชาติ และเยี่ยมชมด้านในของสถานที่ต่างๆ เช่น พิพิธภัณฑ์ สนามกีฬา ร้านอาหาร หรือธุรกิจขนาดย่อมด้วย Street View ปลายทาง API นี้ให้สิทธิ์คุณเข้าถึงสิ่งต่อไปนี้

  • ชิ้นส่วนแผนที่ Street View ของ Google Maps
  • ข้อมูลเมตาของ Street View
  • ภาพขนาดย่อของ Street View

คุณสามารถต่อชิ้นส่วนภาพที่ถ่ายจากระดับถนนเข้าด้วยกันเพื่อสร้างเอฟเฟกต์พาโนรามาสมจริง และคุณสามารถค้นหารหัสพาโนรามาได้ถึง 100 รหัสสำหรับสถานที่หนึ่งๆ (เช่น เส้นทาง) และดูข้อมูลเมตาที่ละเอียดยิ่งขึ้นเกี่ยวกับตำแหน่งของกล้อง

ผู้ชมต้องต่อชิ้นส่วน Street View เข้าด้วยกัน เช่น โปรแกรมดูภาพพาโนรามาที่กำหนดเอง Street View

เมื่อมีคีย์ API แล้ว คุณจะเข้าถึงภาพ Street View ได้โดยทำตามขั้นตอนต่อไปนี้

  1. รับโทเค็นเซสชัน อย่าลืมตั้งค่า mapType เป็น streetview

  2. ใช้โทเค็นเซสชันเพื่อรับตัวระบุพาโนรามา (panoId) ของสถานที่ตั้งทางภูมิศาสตร์อย่างน้อย 1 แห่ง

  3. ใช้ตัวระบุพาโนรามาจากการตอบสนองการค้นหาพาโนรามาเพื่อรับสิ่งต่อไปนี้

    1. ข้อมูลเมตาของ Street View คุณสามารถดูข้อมูลเมตา Street View โดยการส่งชุดพิกัดและรัศมี

    2. ภาพขนาดย่อของ Street View

    3. ชิ้นส่วนแผนที่ Street View

วิธีการของ Street View

คุณเข้าถึงภาพและข้อมูลเมตาของ Street View ได้โดยเรียกใช้วิธีใดวิธีหนึ่งจาก 4 วิธีต่อไปนี้

วิธีการ คำอธิบาย
https://tile.googleapis.com/v1/streetview/tiles แสดงชิ้นส่วน Street View แต่ละชิ้น คุณสามารถเรียกดูชิ้นส่วนแผนที่ Street View ที่ระดับการซูม 6 ระดับ ได้แก่ ตั้งแต่ 512 พิกเซล สูงสุดถึง 13,312 พิกเซล
https://tile.googleapis.com/v1/streetview/panoIds ให้คุณค้นหาสถานที่ตั้งจํานวนมากพร้อมกันได้สูงสุด 100 แห่ง แสดงรหัสพาโนรามาของสถานที่ทั้งหมดที่มีภาพ
https://tile.googleapis.com/v1/streetview/thumbnail แสดงภาพขนาดย่อ JPEG ของฉาก Street View ให้คุณระบุส่วนหัว การเสนอขาย ขนาด และขอบเขตการมองเห็น ขนาดขั้นต่ำคือ 16x16 พิกเซล ขนาดสูงสุดคือ 250x600 พิกเซล
https://tile.googleapis.com/v1/streetview/metadata ให้ข้อมูลโดยละเอียดเกี่ยวกับภาพพาโนรามาที่ระบุไว้ รายละเอียดต่างๆ ได้แก่ ที่อยู่ที่เกี่ยวข้องและลิงก์ไปยังภาพพาโนรามาที่อยู่ติดกัน

คุณสามารถค้นหาตัวระบุพาโนรามาของสถานที่ตั้งทางภูมิศาสตร์อย่างน้อย 1 แห่งโดยการส่งพิกัด (lat, lng) ไปยังเมธอด panoIds เนื้อหาคําขอเป็นออบเจ็กต์ JSON ที่มีอาร์เรย์ locations และ radius (ไม่บังคับ) ดังที่แสดงในตัวอย่างโค้ด JSON ต่อไปนี้

curl -X POST -d '{
  "locations": [
    {"lat": -33.883837, "lng": 151.209307},
    {"lat": -33.883700, "lng": 151.210307},
    {"lat": 0, "lng": 0}
  ],
  "radius": 50
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"
locations
อาร์เรย์ locations ต้องมีค่าพิกัดอย่างน้อย 1 ชุด แต่คุณสามารถใส่เพิ่มได้สูงสุด 100 ชุด
radius
ค่า radius (วัดเป็นเมตร) จะกำหนดรัศมีของวงกลมรอบสถานที่ที่กำหนด ซึ่งจะค้นหาภาพพาโนรามา ค่าเริ่มต้นคือ 50 เมตร

การตอบกลับ PanoId

Map Tiles API จะพยายามค้นหาภาพพาโนรามาที่อยู่ใกล้กับแต่ละสถานที่มากที่สุด จากนั้นจะแสดงรหัสภาพพาโนรามา คำขอ panoIds ที่สำเร็จจะแสดงออบเจ็กต์ JSON ที่มีอาร์เรย์ panoIds อาร์เรย์มีรายการรหัสพาโนรามา ตามลำดับที่คุณขอ หาก Map Tiles API ไม่พบภาพพาโนรามาของสถานที่ที่คุณขอ สตริงว่างจะแสดงผลที่ตำแหน่งนั้นในอาร์เรย์ ตัวอย่างเช่น โปรดดู โค้ด JSON ต่อไปนี้

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

คุณสามารถใช้ panoIds เพื่อทำสิ่งต่อไปนี้

ข้อมูลเมตาของ Street View

คำขอข้อมูลเมตาของ Street View จะเรียกข้อมูลเกี่ยวกับพาโนรามา คำขอข้อมูลเมตาของ Street View เป็นคำขอ HTTPS GET คุณเรียกดูข้อมูลเกี่ยวกับพาโนรามาได้ 2 วิธีดังนี้

  • หากคุณส่ง pano_id แล้ว Map Tiles API จะแสดงข้อมูลเมตาสำหรับภาพพาโนรามานั้น

  • แต่หากคุณผ่าน lat และ lng แล้ว Map Tiles API จะแสดงข้อมูลเมตา ของภาพพาโนรามาที่ใกล้ที่สุดภายในรัศมีการค้นหาที่กำหนด

ส่งชุดพิกัดและรัศมี

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=lat&lng=lng&radius=meters"

เนื่องจากรหัสพาโนรามาเป็นแบบชั่วคราว เราจึงขอแนะนำให้คุณส่งชุดพิกัดและค่า radius ในคำขอข้อมูลเมตา Street View เริ่มต้น ดูตัวอย่างข้อมูลโค้ดต่อไปนี้

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=47.62066&lng=-122.34923&radius=50"

ส่งพาโนรามาของรูปภาพ Street View

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

การตอบกลับข้อมูลเมตา

โค้ด JSON ต่อไปนี้เป็นตัวอย่างการตอบสนองของข้อมูลเมตาโดยทั่วไป

{
 "panoId": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
 "addressComponents": [
  {
   "longName": "United States",
   "shortName": "United States",
   "types": [
    "country"
   ]
  },
  {
   "longName": "Mountain View, California",
   "shortName": "Mountain View, California",
   "types": [
    "locality"
   ]
  },
  {
   "longName": "Charleston Rd",
   "shortName": "Charleston Rd",
   "types": [
    "route"
   ]
  },
  {
   "longName": "1635",
   "shortName": "1635",
   "types": [
    "street_number"
   ]
  }
 ],
 "links": [
  {
   "panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
   "heading": 274.47998046875,
   "text": "Charleston Rd"
  },
  {
   "panoId": "1cODYwFRw1aZ45IignDIMw",
   "heading": 94.47999572753906,
   "text": "Charleston Rd"
  }
 ]
}

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

panoId
รหัสที่ไม่ซ้ำกันของพาโนรามานี้ คุณไม่ควรพึ่งพารหัสพาโนรามาที่ใช้งานได้ นานกว่า 1 เซสชันของผู้ใช้
lat lng
พิกัด (ละติจูดและลองจิจูด) ของพาโนรามา ค่าเหล่านี้อาจแตกต่างจากพิกัดที่คุณส่งไปในคำขอเพราะตำแหน่งจะสแนปไปยังภาพพาโนรามาที่ใกล้ที่สุด
imageHeight imageWidth
ขนาดของภาพพาโนรามาที่เย็บไว้
tileHeight tileWidth
ขนาดของภาพพาโนรามา 1 ภาพ
heading
ทิศทางของเข็มทิศวัดองศาตามเข็มนาฬิกาจากทิศเหนือ ระบบจะแสดงผลส่วนหัวภายในช่วง [0,360] โดย 0 แทนค่าทิศเหนือ
tilt
การเอียงของภาพพาโนรามาซึ่งวัดเป็นองศาจากขั้วโลกใต้ของพาโนรามาไปถึงขอบฟ้า ค่าที่ส่งคืนอยู่ในช่วง [0, 180] ค่า 90 องศาบ่งชี้ว่าแนวเส้นขอบฟ้ามีแนวเส้นศูนย์สูตรอยู่แล้ว
roll
การหมุนตามเข็มนาฬิการอบแนวสายตาที่ใช้กับพาโนรามาเพื่อจัดระดับแนวเส้นขอบฟ้า ค่าที่ได้อยู่ในช่วง [0, 360]
imageryType
ระบุประเภทของรูปภาพ ค่าที่ถูกต้องคือ indoor และ outdoor
date
วันที่ถ่ายภาพ บางรูปภาพอาจไม่มีข้อมูลวันที่ แต่เมื่อพร้อมใช้งาน ช่องนี้จะมีชุดค่าผสมของปี (YYYY) และเดือน (MM) เช่น 2023-05 หรือ 2024
copyright
ข้อความลิขสิทธิ์ที่คุณต้องแสดงเป็นการระบุแหล่งที่มาพร้อมกับรูปภาพ Street View
reportProblemLink
ไฮเปอร์ลิงก์เพื่อให้ผู้ใช้ใช้เพื่อรายงานปัญหาเกี่ยวกับการ์ด Street View นี้ คุณต้องแสดงไฮเปอร์ลิงก์นี้ที่มุมขวาล่างของรูปภาพ และต้องมีข้อความของลิงก์อย่างเช่น "รายงานปัญหาเกี่ยวกับรูปภาพนี้"
addressComponent
รหัสพิกัดภูมิศาสตร์ที่มีโครงสร้างซึ่งมีรายละเอียดเกี่ยวกับที่อยู่ของภาพพาโนรามา ดูข้อมูลเพิ่มเติมได้ในคำขอและการตอบกลับเกี่ยวกับการระบุพิกัดทางภูมิศาสตร์ในเอกสารประกอบของ Geocoding API
links
รายการรหัสพาโนรามาที่ลิงก์ไปยังรายการนี้ นอกจากนี้ยังมีส่วนหัว ที่แสดงลิงก์ดังกล่าวด้วย ตัวอย่างเช่น ถ้าทิศทางเป็น 180° ภาพพาโนรามาที่ลิงก์ก็จะอยู่ทางใต้ของภาพพาโนรามาปัจจุบัน โปรดทราบว่าเนื่องจากรหัสพาโนรามามีลักษณะชั่วคราว คุณจึงไม่ควรพึ่งพารหัสเหล่านี้สำหรับเซสชันของผู้ใช้รายเดียวมากกว่า 1 ครั้ง

ภาพขนาดย่อของ Street View

คุณขอภาพ Street View ได้ในรูปแบบ thumbnail ภาพขนาดย่อคือรูปภาพที่ไม่ได้เรียงต่อกันซึ่งมีขนาด ส่วนหัว ระดับเสียง และขอบเขตการมองเห็นที่กำหนดโดยผู้ใช้ ภาพขนาดย่อมีความละเอียดต่ำกว่าภาพไทล์และมีขนาดไฟล์เล็กกว่า คุณส่งคำขอภาพขนาดย่อได้โดยส่งคำขอ GET ไปยังปลายทาง thumbnail ดังที่แสดงในต้นแบบโค้ดต่อไปนี้

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId&height=FROM_16_TO_250&width=FROM_16_TO_600&pitch=FROM-90_TO_90&yaw=FROM-360_TO_360&fov=FROM_30_TO_120"

ลองดูตัวอย่างโค้ดต่อไปนี้ ซึ่งจะดาวน์โหลดภาพขนาดย่อของภาพ Street View ที่ถ่ายที่ Whistler แคนาดา

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=Zzl28rqGJgaL2IdkUleP8A&height=200&width=200&pitch=0&yaw=250&fov=80" --output /tmp/example_thumbnail.png

ภาพขนาดย่อของ Street View ที่ Whistler แคนาดา

พารามิเตอร์ที่จำเป็น

panoId
รหัสที่ไม่ซ้ำกันของภาพขนาดย่อที่ต้องการ คุณสามารถดูค่ารหัสพาโนรามาได้จากปลายทาง panoIds หรือจากปลายทาง metadata ซึ่งทั้งคู่ยอมรับพิกัดทางภูมิศาสตร์ และแสดงผล panoId ที่เหมาะสม
session
โทเค็นเซสชันที่ถูกต้อง
key
คีย์ API ของคุณ

พารามิเตอร์ที่ไม่บังคับ

height
ระบุความสูงของภาพขนาดย่อเป็นพิกเซลตั้งแต่ 16 ถึง 250 พิกเซล หากคุณไม่ระบุความสูง ความสูงจะมีค่าเริ่มต้นเป็น 250 พิกเซล ซึ่งเป็นค่าสูงสุดที่อนุญาต หากคุณระบุค่าที่ไม่อยู่ในช่วง ภาพขนาดย่อจะสแนปเป็นค่าที่ถูกต้องที่ใกล้เคียงที่สุด
width
ระบุความกว้างของภาพขนาดย่อเป็นพิกเซลตั้งแต่ 16-600 พิกเซล หากไม่ระบุความกว้าง ความกว้างจะมีค่าเริ่มต้นเป็นค่าที่อนุญาตสูงสุด 600 พิกเซล หากระบุค่าที่ไม่อยู่ในช่วง ภาพขนาดย่อจะสแนปเป็นค่าที่ถูกต้องที่ใกล้เคียงที่สุด
pitch
ระบุมุมของกล้องตามแกนแนวตั้ง ค่าที่ถูกต้องจะอยู่ในช่วง -90 ถึง 90 (รวม) ค่าเริ่มต้นคือ 0
yaw
ระบุทิศทางของกล้องตามแกนแนวนอน ค่าที่ถูกต้องจะอยู่ในช่วง -360 ถึง 360 (รวม) ค่าเริ่มต้นคือ 0
fov
ระบุขอบเขตการมองเห็นในแนวนอนซึ่งแสดงเป็นองศาที่มีค่าไม่เกิน 120 เมื่อจัดการกับวิวพอร์ตขนาดคงที่ เช่นเดียวกับภาพ Street View ในขนาดที่กำหนด ฟิลด์ของมุมมองจะหมายถึงการซูม โดยค่าที่น้อยกว่าหมายถึงระดับการซูมที่สูงขึ้น ค่าเริ่มต้นคือ 90

ชิ้นส่วนภาพ Street View

เมื่อมี panoId คุณจะขอไทล์รูปภาพ Street View ได้ คำขอการ์ดคือคำขอ HTTPS GET ลองดูตัวอย่างต่อไปนี้

curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

ในตัวอย่างโค้ดนี้ z คือระดับการซูม และ x และ y คือพิกัดชิ้นส่วนของไทล์ Street View ที่คุณต้องการ ระดับการซูมในภาพพาโนรามาของ Street View ต้องอยู่ในช่วง [0,5] โดย 0 จะแสดงขอบเขตการมองเห็นที่กว้างที่สุด

ระดับการซูม ขอบเขตการมองเห็นโดยประมาณ
0 360°
1 180 องศา
2 90°
3
4 22.5°
5 11.25°

การตอบกลับชิ้นส่วนแผนที่ Street View

คำขอการ์ด Street View ที่ประสบความสำเร็จจะแสดงรูปภาพรูปแบบและขนาดที่คุณระบุไว้ในการตอบกลับ createSession

ผลลัพธ์ของคำขอ Tile ที่สำเร็จ

เมื่อระดับการซูมเป็น 0 พาโนรามาทั้งหมดจะถูกปรับขนาดเป็นชิ้นส่วนขนาด tileWidth x tileHeight เนื่องจากภาพพาโนรามามีขนาดใหญ่กว่าขนาด x การ์ดจะมีช่องว่างในขนาด y

ระดับการซูมเป็นศูนย์

ในระดับการซูมที่ 5 ภาพพาโนรามาขนาดเต็มจะถูกนำมาใช้และแบ่งออกเป็นชิ้นส่วน

คุณจะต้องแสดงข้อมูลลิขสิทธิ์ในภาพพาโนรามาของ Street View ทุกภาพ สตริงที่แสดงอาจแตกต่างกันไปในแต่ละพาโนรามา หากต้องการข้อมูลลิขสิทธิ์ คุณต้องขอข้อมูลเมตาของ Street View แล้วอ้างอิงช่อง copyright ของการตอบกลับได้ ดูข้อมูลเพิ่มเติมได้ที่การระบุแหล่งที่มาของข้อมูล