กล้องและมุมมอง

เลือกแพลตฟอร์ม: Android iOS JavaScript

เมื่อใช้ Maps SDK สำหรับ iOS คุณสามารถเปลี่ยนมุมมองของแผนที่ของผู้ใช้โดยเปลี่ยนกล้องของแผนที่

Maps SDK สำหรับ iOS ช่วยให้ผู้ใช้สามารถเอียงและหมุนแผนที่เพื่อปรับทิศทางให้เข้ากับบริบทของตนได้ ไม่ว่าจะซูมที่ระดับการซูมใดก็ตาม ผู้ใช้สามารถเลื่อนแผนที่หรือเปลี่ยนมุมมองได้โดยใช้เวลาในการตอบสนองน้อยมาก

การเปลี่ยนแปลงกล้องจะไม่เปลี่ยนแปลงเครื่องหมาย เส้นประกอบ หรือกราฟิกอื่นๆ ที่คุณเพิ่ม แต่คุณอาจต้องการเปลี่ยนส่วนเพิ่มเติมเหล่านี้เพื่อให้เข้ากับมุมมองใหม่มากขึ้น

มุมมองแผนที่

Maps SDK สำหรับ iOS ใช้เส้นโครงเมอร์เพื่อแสดงพื้นผิวโลก (ทรงกลม) บนหน้าจอของอุปกรณ์ (ระนาบแบน)

ตำแหน่งกล้อง

มุมมองแผนที่จะสร้างเป็นกล้องที่มองลงล่างบนระนาบแบน คุณสมบัติของกล้องถ่ายรูป (และดังนั้น การแสดงภาพแผนที่) จึงกำหนดโดยคุณสมบัติต่อไปนี้ เป้าหมาย (ตำแหน่งละติจูด/ลองจิจูด) ทิศทาง เอียง และซูม

แผนภาพคุณสมบัติของกล้อง

เป้าหมาย (สถานที่ตั้ง)

เป้าหมายของกล้องคือตำแหน่งของจุดศูนย์กลางของแผนที่ ซึ่งระบุเป็นพิกัดละติจูดและลองจิจูด

ละติจูดอยู่ระหว่าง -85 ถึง 85 องศา ค่าที่สูงกว่าหรือต่ำกว่าช่วงนี้จะถูกบีบให้เป็นค่าที่ใกล้เคียงที่สุดภายในช่วงนี้ เช่น การระบุละติจูดเป็น 100 จะกำหนดค่าเป็น 85 ช่วงลองจิจูดระหว่าง -180 ถึง 180 องศา ค่าที่สูงกว่าหรือต่ำกว่าช่วงนี้จะถูกรวมให้อยู่ในช่วง (-180, 180) เช่น 480, 840 และ 1200 ทั้งหมดจะตัดเป็น 120 องศา

ทิศทาง (การวางแนว)

ทิศทางของกล้องจะระบุทิศทางของเข็มทิศ โดยวัดเป็นองศาจากทิศเหนือจริง โดยสัมพันธ์กับขอบด้านบนของแผนที่ หากคุณวาดเส้นแนวตั้งจากศูนย์กลางของแผนที่ไปยังขอบด้านบนของแผนที่ ทิศทางจะสอดคล้องกับส่วนหัวของกล้อง (วัดเป็นองศา) ซึ่งสัมพันธ์กับทิศเหนือจริง

เครื่องหมาย 0 หมายความว่าด้านบนของแผนที่จะชี้ไปทางทิศเหนือจริง ค่าทิศทาง 90 หมายถึงด้านบนของจุดบนแผนที่ตั้งไปทางทิศตะวันออก (90 องศาบนเข็มทิศ) ค่า 180 หมายถึงด้านบนของจุดในแผนที่ที่ครบกำหนดไปทางทิศใต้

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

เอียง (มุมการดู)

การเอียงจะกำหนดตำแหน่งของกล้องบนเส้นโค้งเหนือตำแหน่งศูนย์กลางของแผนที่ วัดเป็นองศาจากจุดต่ำสุด (ทิศทางที่ชี้อยู่ใต้กล้อง) ค่า 0 หมายถึงกล้องที่ชี้ลง ค่าที่มากกว่า 0 จะหมายถึงกล้องที่หันเข้าหาขอบฟ้าตามจำนวนองศาที่ระบุ เมื่อคุณเปลี่ยนมุมมอง แผนที่จะปรากฏในมุมมอง โดยจุดสนใจที่อยู่ไกลจะปรากฏขึ้นมีขนาดเล็กลง และจุดสนใจใกล้เคียงจะมีขนาดใหญ่ขึ้น ภาพประกอบต่อไปนี้จะสาธิตให้เห็นถึงเรื่องนี้

ในภาพด้านล่าง มุมมองคือ 0 องศา ภาพแรกแสดงสคีมาของข้อมูลนี้ ตำแหน่ง 1 คือตำแหน่งของกล้อง และตำแหน่ง 2 คือตำแหน่งแผนที่ปัจจุบัน แผนที่ที่ได้จะแสดงอยู่ใต้แผนที่

ภาพหน้าจอของแผนที่ที่มีกล้องอยู่ในตำแหน่งมุมมอง 0 องศา ที่ระดับการซูม 18 องศา
แผนที่ที่แสดงด้วยมุมมองเริ่มต้นของกล้อง
แผนภาพที่แสดงตำแหน่งเริ่มต้นของกล้องเหนือตำแหน่งแผนที่ โดยทำมุม 0 องศา
มุมมองเริ่มต้นของกล้อง

ในภาพด้านล่าง มุมมองคือ 45 องศา สังเกตว่ากล้องจะเคลื่อนครึ่งทางแนวโค้งระหว่างจุดเหนือศีรษะตรง (0 องศา) และพื้น (90 องศา) ไปยังตำแหน่ง 3 กล้องยังคงชี้ไปที่จุดศูนย์กลางของแผนที่ แต่ตอนนี้จะเห็นพื้นที่ที่เป็นเส้นตรง 4 แล้ว

ภาพหน้าจอของแผนที่ที่มีกล้องอยู่ในตำแหน่งมุมมอง 45 องศา ที่ระดับการซูม 18
แผนที่ที่แสดงโดยมีมุมการดู 45 องศา
แผนภาพแสดงมุมมองของกล้องที่ตั้งค่าเป็น 45 องศา โดยยังคงตั้งค่าระดับการซูมเป็น 18 องศา
มุมมองของกล้อง 45 องศา

แผนที่ในภาพหน้าจอนี้ยังคงอยู่ที่จุดศูนย์กลางของจุดเดียวกับแผนที่เดิม แต่มีคุณลักษณะอื่นๆ ปรากฏขึ้นที่ด้านบนของแผนที่ เมื่อคุณเพิ่มมุมขึ้นจนเกิน 45 องศา จุดสนใจระหว่างกล้องและตำแหน่งแผนที่จะปรากฏใหญ่ขึ้นตามสัดส่วน ในขณะที่จุดสนใจนอกตำแหน่งแผนที่จะปรากฏขนาดเล็กลงตามสัดส่วน ซึ่งให้เอฟเฟ็กต์แบบ 3 มิติ

Zoom

ระดับการซูมของกล้องเป็นตัวกำหนดขนาดของแผนที่ ในระดับการซูมที่ใหญ่ขึ้น คุณจะเห็นรายละเอียดมากขึ้นบนหน้าจอ ส่วนระดับการซูมที่เล็กลงจะสามารถมองเห็นสิ่งต่างๆ ได้บนหน้าจอมากขึ้น ที่ระดับการซูม 0 มาตราส่วนของแผนที่หมายถึงโลกทั้งใบมีความกว้างประมาณ 256 จุด

การเพิ่มระดับการซูม 1 เป็น 2 เท่าของความกว้างของโลกบนหน้าจอ ดังนั้นที่ระดับการซูม N ความกว้างโลกคือประมาณ 256 * 2N จุด ตัวอย่างเช่น เมื่อซูมระดับ 2 โลกทั้งโลกมีความกว้างประมาณ 1,024 จุด

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

  • 1: ข่าวทั่วโลก
  • 5: ผืนดินขนาดใหญ่/ทวีป
  • 10: เมือง
  • 15: ถนน
  • 20: อาคาร
รูปภาพต่อไปนี้จะแสดงลักษณะที่ปรากฏในระดับการซูมต่างๆ
ภาพหน้าจอของแผนที่ที่ระดับการซูม 5
แผนที่ที่ระดับการซูม 5
ภาพหน้าจอของแผนที่ที่ระดับการซูม 15
แผนที่ที่ระดับการซูม 15
ภาพหน้าจอของแผนที่ที่ระดับการซูม 20
แผนที่ที่ระดับการซูม 20

กำหนดตำแหน่งกล้องเริ่มต้น

กำหนดตำแหน่งกล้องเริ่มต้นโดยใช้ออบเจ็กต์ GMSCameraPosition ซึ่งช่วยให้กำหนดละติจูดและลองจิจูดของเป้าหมายพร้อมกับการเอียง เอียง และซูมได้

หากต้องการตั้งค่าตำแหน่งกล้องเริ่มต้น ให้สร้างวัตถุ GMSMapViewOptions และตั้งค่าพร็อพเพอร์ตี้ camera เป็น GMSCameraPosition จากนั้นส่งตัวเลือกไปยังเครื่องมือสร้างความสะดวกของ GMSMapView

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 16)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:16];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

คุณยังสร้างออบเจ็กต์ GMSMapView โดยใช้เมธอดเริ่มต้น UIView ได้ด้วย ในกรณีนี้ ตำแหน่งของกล้องจะเริ่มที่ตำแหน่งเริ่มต้นและคุณเปลี่ยนหลังจากสร้างแล้ว

Swift

let options = GMSMapViewOptions()
options.frame = self.view.bounds
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.frame = self.view.bounds;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

เปลี่ยนตำแหน่งกล้อง

คุณสามารถเปลี่ยนตำแหน่งของกล้องโดยใช้โปรแกรมเพื่อตั้งค่าตำแหน่ง ความสูง การเอียง และการซูม แม้ว่า GMSMapView จะมีหลายวิธีที่คุณสามารถใช้เพื่อเปลี่ยนตำแหน่งของกล้อง แต่โดยทั่วไปจะใช้ GMSCameraPosition หรือ GMSCameraUpdate ดังนี้

  • GMSCameraPosition มีพร็อพเพอร์ตี้และวิธีการที่คุณใช้เปลี่ยนพารามิเตอร์ตำแหน่งของกล้องทั้งหมด ได้แก่ เป้าหมาย ทิศทาง การเอียง และการซูม

  • GMSCameraUpdate ช่วยให้คุณเปลี่ยนเป้าหมาย ทิศทาง การเอียง และการซูม และยังมีวิธีการอื่นๆ ที่ช่วยอำนวยความสะดวกในการเลื่อน การซูมขั้นสูง การจัดกล้องให้อยู่กึ่งกลางภายในขอบเขตที่กำหนดไว้ล่วงหน้า และอีกมากมาย

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

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

ใช้ GMSCameraPosition

หากต้องการเปลี่ยนกล้องด้วย GMSCameraPosition ให้สร้างวัตถุใหม่หรือคัดลอกวัตถุที่มีอยู่แล้วไปวางบนวัตถุ GMSMapView ใช้วัตถุ GMSCameraPosition เพื่อสแนปกล้องไปยังตำแหน่งใหม่แบบมีหรือไม่มีภาพเคลื่อนไหว

ใช้วัตถุ GMSCameraPosition เพื่อกำหนดค่าคุณสมบัติต่างๆ ของกล้อง เช่น ละติจูด ลองจิจูด การซูม ทิศทาง และมุมมอง จากนั้นใช้ออบเจ็กต์ดังกล่าวเพื่อตั้งค่าพร็อพเพอร์ตี้ camera ของ GMSMapView

Swift

let fancy = GMSCameraPosition(
  latitude: -33,
  longitude: 151,
  zoom: 6,
  bearing: 270,
  viewingAngle: 45
)
mapView.camera = fancy

Objective-C

GMSCameraPosition *fancy = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                       longitude:151.2086
                                                            zoom:6
                                                         bearing:30
                                                    viewingAngle:45];
[mapView setCamera:fancy];

ข้ามพร็อพเพอร์ตี้ GMSCameraPosition ที่คุณต้องการตั้งเป็นค่าเริ่มต้น

หากต้องการให้การเคลื่อนไหวเคลื่อนไหว ให้ใช้เมธอด animateToCameraPosition: แทนการตั้งค่าพร็อพเพอร์ตี้ camera

ใช้ GMSCameraUpdate

GMSCameraUpdate ช่วยให้คุณอัปเดตตำแหน่งของกล้อง และเลือกว่าจะสแนปไปยังจุดใหม่หรือภาพเคลื่อนไหวไปยังตำแหน่งใหม่นั้นได้ ข้อดีของ GMSCameraUpdate คือความสะดวก คุณใช้ GMSCameraPosition เพื่อทำงานแบบเดียวกับ GMSCameraUpdate ได้ แต่ GMSCameraUpdate จะมีวิธีการของตัวช่วยเพิ่มเติมเพื่อให้ควบคุมกล้องได้ง่ายขึ้น

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

หรือจะสร้างออบเจ็กต์ GMSCameraUpdate ด้วยเมธอด zoomIn: จากนั้นอัปเดตกล้องโดยส่งวัตถุ GMSCameraUpdate ไปยังเมธอด GMSMapView animateWithCameraUpdate:

Swift

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)

Objective-C

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];

ให้ใช้เมธอด moveCamera: ของ GMSMapView เพื่อสแนปกล้องไปยังตำแหน่งใหม่แทน

ในตัวอย่างถัดไป คุณใช้ GMSCameraUpdate เพื่อสร้างภาพเคลื่อนไหวของกล้องให้อยู่ตรงกลางแวนคูเวอร์

Swift

// Center the camera on Vancouver, Canada
let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let vancouverCam = GMSCameraUpdate.setTarget(vancouver)
mapView.animate(with: vancouverCam)

Objective-C

// Center the camera on Vancouver, Canada
CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
GMSCameraUpdate *vancouverCam = [GMSCameraUpdate setTarget:vancouver];
[mapView animateWithCameraUpdate:vancouverCam];

สร้างออบเจ็กต์ GMSCameraUpdate

สร้างออบเจ็กต์ GMSCameraUpdate โดยใช้วิธีใดวิธีหนึ่ง

zoomIn:และzoomOut:
เปลี่ยนระดับการซูมปัจจุบันทีละ 1.0 โดยคงคุณสมบัติอื่นๆ ทั้งหมดไว้เหมือนเดิม
zoomTo:
เปลี่ยนระดับการซูมเป็นค่าที่ระบุโดยคงคุณสมบัติอื่นๆ ทั้งหมดไว้เหมือนเดิม
zoomBy:
เพิ่ม (หรือลด หากค่าเป็นค่าลบ) ระดับการซูมตามค่าที่ระบุ
zoomBy:atPoint:
เพิ่มหรือลดระดับการซูมด้วยค่าที่กำหนด (หรือลดลง หากค่าเป็นลบ) ขณะเดียวกันก็ยังคงรักษาตำแหน่งของจุดที่ระบุบนหน้าจอไว้
setTarget:
เปลี่ยนละติจูดและลองจิจูดของกล้องโดยเก็บพร็อพเพอร์ตี้อื่นๆ ทั้งหมดไว้
setTarget:zoom:
เปลี่ยนละติจูด ลองจิจูด และการซูมของกล้องโดยที่ยังคงเก็บคุณสมบัติอื่นๆ ไว้ทั้งหมด
setCamera:
ตั้งค่า GMSCameraPosition ใหม่
scrollByX:Y:
เปลี่ยนละติจูดและลองจิจูดของกล้องเพื่อย้ายแผนที่ตามจำนวนจุดที่ระบุ ค่า x ที่เป็นค่าบวกจะทำให้กล้องเคลื่อนไปทางขวา ดังนั้นแผนที่จะปรากฏไปทางซ้าย ค่า y บวกจะทำให้กล้องเลื่อนลง ดังนั้นแผนที่จึงดูเหมือนย้ายขึ้น การเลื่อนจะสัมพันธ์กับทิศทางปัจจุบันของกล้อง เช่น หากกล้องถ่ายรูปตั้งรับ 90 องศา ทิศตะวันออกก็จะเป็น "ขึ้น"
fitBounds:
เปลี่ยนกล้องให้อยู่ตรงกลางของขอบเขตที่ระบุบนหน้าจอในระดับการซูมสูงสุดเท่าที่จะเป็นไปได้ ใช้ระยะห่างจากขอบเริ่มต้นกับขอบเขตของ 64 จุด
fitBounds:withPadding:
เปลี่ยนกล้องให้อยู่ตรงกลางของขอบเขตที่ระบุบนหน้าจอในระดับการซูมสูงสุดเท่าที่จะเป็นไปได้ ใช้วิธีนี้เพื่อระบุระยะห่างจากขอบเดียวกันเป็นจุดสำหรับขอบทุกด้านของกรอบล้อมรอบ
fitBounds:withEdgeInsets:
เปลี่ยนกล้องให้อยู่ตรงกลางของขอบเขตที่ระบุบนหน้าจอในระดับการซูมสูงสุดเท่าที่จะเป็นไปได้ เมื่อใช้ UIEdgeInsets คุณจะระบุระยะห่างจากขอบสำหรับแต่ละด้านของกรอบล้อมรอบแยกจากกัน

ใช้ GMSMapView เพื่อเปลี่ยนพร็อพเพอร์ตี้เดียว

GMSMapView มีวิธีมากมายที่ช่วยให้คุณย้ายกล้องได้โดยไม่ต้องใช้ วัตถุ GMSCameraPosition หรือวัตถุ GMSCameraUpdate ด้วยวิธีการเหล่านี้ เช่น animateToLocation: หรือ animateToZoom: คุณจะสร้างภาพเคลื่อนไหวการเปลี่ยนแปลงคุณสมบัติกล้องตัวเดียวได้

เช่น ใช้เมธอด toViewingAngle: เพื่อทำให้การเปลี่ยนแปลงการเอียงกล้องเคลื่อนไหวได้

Swift

mapView.animate(toViewingAngle: 45)

Objective-C

[mapView animateToViewingAngle:45];

กําหนดเป้าหมาย (สถานที่ตั้ง)

ตำแหน่งจะเป็นตัวกำหนดศูนย์กลางของแผนที่ สถานที่ตั้งจะกำหนดโดยใช้ละติจูดและลองจิจูด และแสดงเป็น CLLocationCoordinate2D แบบเป็นโปรแกรม ซึ่งสร้างขึ้นด้วย CLLocationCoordinate2DMake

ใช้ GMSCameraPosition เพื่อเปลี่ยนสถานที่ ในตัวอย่างนี้ แผนที่จะสแนปไปยัง ตำแหน่งใหม่

Swift

let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208)
mapView.camera = GMSCameraPosition(target: target, zoom: 6)

Objective-C

CLLocationCoordinate2D target =
    CLLocationCoordinate2DMake(-33.868, 151.208);
mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];

หากต้องการให้การเปลี่ยนแปลงเคลื่อนไหวและเลื่อนแผนที่ไปยังตำแหน่งใหม่ คุณใช้เมธอด animateToCameraPosition: แทนการตั้งค่าพร็อพเพอร์ตี้ camera ได้ หรือใช้เมธอด animateToLocation: ใน GMSMapView

Swift

mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))

Objective-C

[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];

คุณยังสร้างวัตถุ GMSCameraUpdate เพื่อย้ายกล้องได้ด้วย ให้ใช้เมธอดในตัว scrollByX:Y: เพื่อระบุจำนวนจุดสำหรับเลื่อนกล้องไปในทิศทาง X และ Y ในตัวอย่างนี้ เลื่อนกล้องไปทางขวา 200 จุดและลง 100 จุด

Swift

// Move the camera 200 points to the right, and 100 points downwards
let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100)
mapView.animate(with: downwards)

Objective-C

// Move the camera 200 points to the right, and 100 points downwards
GMSCameraUpdate *downwards = [GMSCameraUpdate scrollByX:200.0 Y:100.0];
[mapView animateWithCameraUpdate:downwards];

ทิศทางของที่ตั้งไว้ (การวางแนว)

ทิศทางของเข็มทิศคือทิศทางของเข็มทิศซึ่งวัดเป็นองศาจากทิศเหนือจริงสำหรับ ขอบด้านบนของแผนที่ เช่น แบก 90 องศาจะแสดงแผนที่โดยที่ขอบด้านบนชี้ไปทางทิศตะวันออก

ตั้งค่าทิศทางแบบเป็นโปรแกรมด้วย GMSCameraPosition หรือ GMSCameraUpdate หรือโดยใช้เมธอด animateToBearing: ของ GMSMapView

Swift

mapView.animate(toBearing: 0)

Objective-C

[mapView animateToBearing:0];

ตั้งค่าการเอียง (มุมมอง)

มุมมองคือตำแหน่งของกล้องบนเส้นโค้งระหว่างตำแหน่งศูนย์กลางของแผนที่กับพื้นผิวโลกโดยตรง โดยวัดเป็นองศาจากจุดต่ำสุด (ทิศทางที่ชี้อยู่ใต้กล้อง) เมื่อคุณเปลี่ยนมุมการดู แผนที่จะปรากฏในมุมมอง โดยมีจุดสนใจระหว่างกล้องและตำแหน่งแผนที่ดูใหญ่ขึ้นตามสัดส่วน และจุดสนใจที่นอกเหนือจากตำแหน่งแผนที่จะปรากฏขนาดเล็กลงอย่างมีสัดส่วน ส่งผลให้มี 3 มิติ

มุมมองสามารถอยู่ในช่วง 0 (ชี้ลงบนแผนที่) และ สูงสุดขึ้นอยู่กับระดับการซูมสูงสุด สำหรับระดับการซูม 16 ขึ้นไป มุมสูงสุดคือ 65 องศา สำหรับการซูมระดับ 10 หรือต่ำกว่า มุมสูงสุดคือ 30 องศา

ตั้งค่ามุมมองแบบเป็นโปรแกรมโดยใช้ GMSCameraPosition หรือ GMSCameraUpdate หรือด้วยเมธอด animateToViewingAngle: ของ GMSMapView

Swift

mapView.animate(toViewingAngle: 45)

Objective-C

[mapView animateToViewingAngle:45];

ตั้งค่าการซูม

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

ตั้งค่าการซูมแบบเป็นโปรแกรมด้วย GMSCameraPosition หรือ GMSCameraUpdate หรือโดยใช้เมธอด animateToZoom: ของ GMSMapView

Swift

mapView.animate(toZoom: 12)

Objective-C

[mapView animateToZoom:12];

ตัวอย่างต่อไปนี้ใช้เมธอด zoomIn: ในการสร้างออบเจ็กต์ GMSCameraUpdate ให้ภาพเคลื่อนไหวการซูมเข้า 1 ระดับจากระดับปัจจุบัน

Swift

// Zoom in one zoom level
let zoomCamera = GMSCameraUpdate.zoomIn()
mapView.animate(with: zoomCamera)

Objective-C

// Zoom in one zoom level
GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn];
[mapView animateWithCameraUpdate:zoomCamera];

กำหนดขอบเขต

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

  1. คำนวณ GMSCoordinateBounds ที่คุณต้องการให้แสดงบนหน้าจอ
  2. ใช้เมธอด cameraForBounds:insets: ของ GMSMapView เพื่อแสดงผล GMSCameraPosition ใหม่

การตั้งค่าขอบเขตเหล่านี้ช่วยให้แน่ใจว่า GMSCoordinateBounds ที่ระบุจะพอดีกับขนาดของแผนที่ปัจจุบันทั้งหมด โปรดทราบว่าวิธีนี้จะตั้งค่าการเอียงและทิศทาง ของแผนที่เป็น 0

ตัวอย่างต่อไปนี้สาธิตวิธีการเปลี่ยนกล้องเพื่อให้ทั้งเมืองแวนคูเวอร์และแคลกะรีปรากฏในมุมมองเดียวกัน

Swift

let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11)
let calgary = CLLocationCoordinate2D(latitude: 51.05,longitude: -114.05)
let bounds = GMSCoordinateBounds(coordinate: vancouver, coordinate: calgary)
let camera = mapView.camera(for: bounds, insets: UIEdgeInsets())!
mapView.camera = camera

Objective-C

CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11);
CLLocationCoordinate2D calgary = CLLocationCoordinate2DMake(51.05, -114.05);
GMSCoordinateBounds *bounds =
    [[GMSCoordinateBounds alloc] initWithCoordinate:vancouver coordinate:calgary];
GMSCameraPosition *camera = [mapView cameraForBounds:bounds insets:UIEdgeInsetsZero];
mapView.camera = camera;

จำกัดการเลื่อนของผู้ใช้ให้อยู่ในพื้นที่ที่กำหนด

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

ตัวอย่างเช่น แอปค้าปลีกสำหรับศูนย์การค้าหรือสนามบินอาจต้องการจำกัดแผนที่ไปยังขอบเขตที่เฉพาะเจาะจง เพื่อให้ผู้ใช้สามารถเลื่อนและแพนภายในขอบเขตเหล่านั้นได้

หากต้องการจำกัดการแพนไปยังขอบเขตที่เฉพาะเจาะจง ให้ตั้งค่าพร็อพเพอร์ตี้ cameraTargetBounds ของ GMSMapView เป็นออบเจ็กต์ GMSCoordinateBounds ที่กำหนดขอบเขตที่จำเป็น หากต้องการนำข้อจำกัดออกในภายหลัง ให้ตั้งค่า cameraTargetBounds เป็น nil

Swift

mapView.cameraTargetBounds = bounds

Objective-C

mapView.cameraTargetBounds = bounds;

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

แผนภาพแสดงขอบเขตของกล้องซึ่งใหญ่กว่าวิวพอร์ต

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

แผนภาพแสดงเป้าหมายของกล้องที่อยู่มุมขวาล่างของขอบเขตกล้อง

ในแผนภาพต่อไปนี้ เป้าหมายของกล้องมีขอบเขตที่จำกัดมาก ซึ่งทำให้ผู้ใช้มีโอกาสน้อยมากที่จะเลื่อนหรือเลื่อนแผนที่ ไม้กางเขนจะแสดง เป้าหมายของกล้อง ดังนี้

แผนภาพแสดงขอบเขตของกล้องที่เล็กกว่าวิวพอร์ต

ตั้งค่าการซูมต่ำสุดหรือสูงสุด

ค่าคงที่ร่วม kGMSMinZoomLevel และ kGMSMaxZoomLevel จะกำหนดค่าการซูมต่ำสุดหรือสูงสุด โดยค่าเริ่มต้น พร็อพเพอร์ตี้ minZoom และ maxZoom ของ GMSMapView จะตั้งค่าเป็นค่าคงที่เหล่านี้

หากต้องการจำกัดช่วงระดับการซูมที่มีในแผนที่ ให้ตั้งค่าระดับการซูมต่ำสุดและสูงสุด โค้ดต่อไปนี้จำกัดระดับการซูมไว้ระหว่าง 10 ถึง 15

Swift

let camera = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 12
)
let mapView = GMSMapView(frame: .zero, camera: camera)
mapView.setMinZoom(10, maxZoom: 15)

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:41.887
                                                       longitude:-87.622
                                                             zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero
                                        camera:camera];
[mapView setMinZoom:10 maxZoom:15];

คุณต้องตั้งค่าช่วงการซูมด้วยเมธอด setMinZoom:maxZoom: แต่จะอ่านค่าปัจจุบันโดยใช้พร็อพเพอร์ตี้ minZoom และ maxZoom ได้ ซึ่งวิธีการนี้มีประโยชน์เมื่อจํากัดค่าใดค่าหนึ่งเท่านั้น โค้ดต่อไปนี้จะเปลี่ยนเฉพาะระดับการซูมขั้นต่ำเท่านั้น

Swift

mapView.setMinZoom(12, maxZoom: mapView.maxZoom)

Objective-C

[mapView setMinZoom:12 maxZoom:mapView.maxZoom];

ถ้าหลังจากอัปเดตการซูมขั้นต่ำและสูงสุดแล้ว มีการตั้งค่าระดับการซูมของกล้องเป็นค่านอกช่วงใหม่ การซูมปัจจุบันจะอัปเดตโดยอัตโนมัติเพื่อแสดงค่าที่ถูกต้องที่ใกล้เคียงที่สุด เช่น ในโค้ดที่ตามหลัง การซูมเดิมกำหนดไว้เป็น 4 เมื่อตั้งค่าช่วงการซูมภายหลังเป็น 10-15 ระดับการซูมปัจจุบันจะอัปเดตเป็น 10

Swift

// Sets the zoom level to 4.
let camera2 = GMSCameraPosition(
  latitude: 41.887,
  longitude: -87.622,
  zoom: 4
)
let mapView2 = GMSMapView(frame: .zero, camera: camera)

// The current zoom, 4, is outside of the range. The zoom will change to 10.
mapView.setMinZoom(10, maxZoom: 15)

Objective-C

// Sets the zoom level to 4.
GMSCameraPosition *camera2 = [GMSCameraPosition cameraWithLatitude:41.887
                                                         longitude:-87.622
                                                              zoom:4];
GMSMapView *mapView2 = [GMSMapView mapWithFrame:CGRectZero
                                         camera:camera];
// The current zoom, 4, is outside of the range. The zoom will change to 10.
[mapView setMinZoom:10 maxZoom:15];