ชิ้นส่วนแผนที่ Street View นั้นคล้ายกับชิ้นส่วน 2 มิติ เว้นแต่มีภาพพาโนรามาที่ถ่ายที่ระดับถนน คุณสามารถสำรวจจุดสังเกตทั่วโลก ดูความมหัศจรรย์ทางธรรมชาติ และเยี่ยมชมด้านในของสถานที่ต่างๆ เช่น พิพิธภัณฑ์ สนามกีฬา ร้านอาหาร หรือธุรกิจขนาดย่อมด้วย Street View ปลายทาง API นี้ให้สิทธิ์คุณเข้าถึงสิ่งต่อไปนี้
- ชิ้นส่วนแผนที่ Street View ของ Google Maps
- ข้อมูลเมตาของ Street View
- ภาพขนาดย่อของ Street View
คุณสามารถต่อชิ้นส่วนภาพที่ถ่ายจากระดับถนนเข้าด้วยกันเพื่อสร้างเอฟเฟกต์พาโนรามาสมจริง และคุณสามารถค้นหารหัสพาโนรามาได้ถึง 100 รหัสสำหรับสถานที่หนึ่งๆ (เช่น เส้นทาง) และดูข้อมูลเมตาที่ละเอียดยิ่งขึ้นเกี่ยวกับตำแหน่งของกล้อง
ผู้ชมต้องต่อชิ้นส่วน Street View เข้าด้วยกัน เช่น โปรแกรมดูภาพพาโนรามาที่กำหนดเอง Street View
เมื่อมีคีย์ API แล้ว คุณจะเข้าถึงภาพ Street View ได้โดยทำตามขั้นตอนต่อไปนี้
รับโทเค็นเซสชัน อย่าลืมตั้งค่า
mapType
เป็นstreetview
ใช้โทเค็นเซสชันเพื่อรับตัวระบุพาโนรามา (panoId) ของสถานที่ตั้งทางภูมิศาสตร์อย่างน้อย 1 แห่ง
ใช้ตัวระบุพาโนรามาจากการตอบสนองการค้นหาพาโนรามาเพื่อรับสิ่งต่อไปนี้
ข้อมูลเมตาของ Street View คุณสามารถดูข้อมูลเมตา 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 |
ให้ข้อมูลโดยละเอียดเกี่ยวกับภาพพาโนรามาที่ระบุไว้ รายละเอียดต่างๆ ได้แก่ ที่อยู่ที่เกี่ยวข้องและลิงก์ไปยังภาพพาโนรามาที่อยู่ติดกัน |
ค้นหาภาพพาโนรามาของ Street View
คุณสามารถค้นหาตัวระบุพาโนรามาของสถานที่ตั้งทางภูมิศาสตร์อย่างน้อย 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
พารามิเตอร์ที่จำเป็น
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 | 7° |
4 | 22.5° |
5 | 11.25° |
การตอบกลับชิ้นส่วนแผนที่ Street View
คำขอการ์ด Street View ที่ประสบความสำเร็จจะแสดงรูปภาพรูปแบบและขนาดที่คุณระบุไว้ในการตอบกลับ createSession
เมื่อระดับการซูมเป็น 0 พาโนรามาทั้งหมดจะถูกปรับขนาดเป็นชิ้นส่วนขนาด tileWidth
x tileHeight
เนื่องจากภาพพาโนรามามีขนาดใหญ่กว่าขนาด x
การ์ดจะมีช่องว่างในขนาด y
ในระดับการซูมที่ 5 ภาพพาโนรามาขนาดเต็มจะถูกนำมาใช้และแบ่งออกเป็นชิ้นส่วน
ข้อมูลลิขสิทธิ์
คุณจะต้องแสดงข้อมูลลิขสิทธิ์ในภาพพาโนรามาของ Street View ทุกภาพ สตริงที่แสดงอาจแตกต่างกันไปในแต่ละภาพพาโนรามา หากต้องการข้อมูลลิขสิทธิ์ คุณต้องขอข้อมูลเมตาของ Street View แล้วอ้างอิงช่อง copyright
ของการตอบกลับได้ ดูข้อมูลเพิ่มเติมได้ที่การระบุแหล่งที่มาของข้อมูล