ภาพรวม
นี่เป็นคลาสหลักของ Google Maps SDK สำหรับ iOS และเป็นจุดแรกเข้าของเมธอดทั้งหมดที่เกี่ยวข้องกับแผนที่
ควรสร้างอินสแตนซ์แผนที่ด้วยตัวสร้างตัวใดตัวหนึ่ง -init หรือ -initWithOptions:
GMSMapView จะอ่านและแก้ไขได้จากเทรดหลักเท่านั้น ซึ่งคล้ายกับออบเจ็กต์ UIKit ทั้งหมด การเรียกเมธอดเหล่านี้จากชุดข้อความอื่นจะทำให้มีข้อยกเว้นหรือลักษณะการทำงานที่ไม่ระบุ
ฟังก์ชันสมาชิกสาธารณะ | |
(instancetype) | - init |
เริ่มต้นด้วย CGRectZero และตัวเลือกเริ่มต้น | |
(instancetype) | - initWithOptions: |
สร้างมุมมองแผนที่ใหม่ตามตัวเลือกที่ให้ไว้ | |
(instancetype) | - initWithFrame: |
(ประเภทอินสแตนซ์ที่เป็นค่าว่าง) | - initWithCoder: |
(instancetype) | - initWithFrame:camera: |
สร้างและแสดงผลมุมมองแผนที่ โดยมีเฟรมและเป้าหมายกล้อง | |
(instancetype) | - initWithFrame:mapID:camera: |
สร้างและแสดงผลมุมมองแผนที่ที่มีเฟรม รหัสแผนที่ และเป้าหมายกล้อง | |
(โมฆะ) | - startRendering |
บอกให้แผนที่นี้เพิ่มประสิทธิภาพโหมดแสดงภาพ | |
(โมฆะ) | - stopRendering |
บอกให้แผนที่นี้ปิดโหมดแสดงภาพ | |
(โมฆะ) | - ล้าง |
ล้างมาร์กอัปทั้งหมดที่เพิ่มลงในแผนที่ รวมถึงเครื่องหมาย เส้นประกอบ และการวางซ้อนพื้น | |
(โมฆะ) | - setMinZoom:maxZoom: |
ตั้งค่า minZoom และ maxZoom | |
(GMSCameraPosition ที่เป็นค่าว่าง *) | - cameraForBounds:insets: |
สร้าง GMSCameraPosition ที่นำเสนอ bounds ด้วย padding | |
(โมฆะ) | - moveCamera: |
เปลี่ยนกล้องตามupdate | |
(บูลีน) | - areEqualForRenderingPosition:position: |
ตรวจสอบว่าตำแหน่งกล้องที่ระบุจะทําให้กล้องแสดงผลเหมือนกันหรือไม่ โดยคํานึงถึงระดับความแม่นยําและการแปลงที่ใช้ภายใน | |
(GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
แสดงผลเลเยอร์ฟีเจอร์ของประเภทที่ระบุ | |
(GMSDatasetFeatureLayer *) | - datasetFeatureLayerOfDatasetID: |
แสดงผลเลเยอร์ฟีเจอร์ชุดข้อมูลของชุดข้อมูลที่ระบุ | |
(โมฆะ) | - invalidateLayoutForAccessoryView: |
ทำให้มุมมองอุปกรณ์เสริมเป็นโมฆะและทริกเกอร์เลย์เอาต์ใหม่สำหรับมุมมองนั้น | |
(โมฆะ) | - setHeaderAccessoryView: |
กำหนดตำแหน่งของมุมมองอุปกรณ์เสริมใต้ส่วนหัวหลักของ UI การนำทาง | |
(โมฆะ) | - animateToCameraPosition: |
ทำให้กล้องของแผนที่นี้เคลื่อนไหวไปยัง cameraPosition | |
(โมฆะ) | - animateToLocation: |
เป็น AnimateToCameraPosition: แต่จะเปลี่ยนแปลงเฉพาะตําแหน่งของกล้อง (นั่นคือ จากตําแหน่งปัจจุบันเป็น location ) | |
(โมฆะ) | - animateToZoom: |
เป็นภาพเคลื่อนไหว (เป็นภาพเคลื่อนไหว) แต่เปลี่ยนเฉพาะระดับการซูมของกล้อง | |
(โมฆะ) | - animateToBearing: |
เป็นภาพเคลื่อนไหว (เป็นองศา) แต่เปลี่ยนเฉพาะทิศทางของกล้องถ่ายรูป (เป็นองศา) | |
(โมฆะ) | - animateToViewingAngle: |
เป็นภาพเคลื่อนไหว (เป็นองศา) แต่เปลี่ยนเฉพาะมุมการดูของกล้อง (เป็นองศา) | |
(โมฆะ) | - animateWithCameraUpdate: |
ใช้ cameraUpdate กับกล้องปัจจุบัน จากนั้นใช้ผลลัพธ์ตาม animateTocameraPosition: | |
(โมฆะ) | - didBeginPanGesture |
ควรเรียกเมธอดนี้จากการใช้งานเมธอด CPMapTemplateDelegate -mapTemplateDidBeginPanGesture: ของแอปพลิเคชันเพื่อใช้ท่าทางสัมผัสการแพนสำหรับเทมเพลตแผนที่ CarPlay | |
(โมฆะ) | - didUpdatePanGestureWithTranslation:velocity: |
ควรเรียกเมธอดนี้จากการใช้งานเมธอด CPMapTemplateDelegate -mapTemplate:didUpdatePanGestureWithTranslation ของแอปพลิเคชัน เพื่อใช้ท่าทางสัมผัสการแพนสำหรับเทมเพลตแผนที่ CarPlay | |
(โมฆะ) | - didEndPanGestureWithVelocity: |
ควรเรียกวิธีนี้จากการใช้งานแอปพลิเคชัน CPMapTemplateDelegate -mapTemplate:didEndPanGestureWithVelocity: เพื่อติดตั้งใช้งานท่าทางสัมผัสการแพนสำหรับเทมเพลตแผนที่ CarPlay | |
(บูลีน) | - enableNavigationWithSession: |
เริ่มการนำทางในมุมมองแผนที่นี้โดยใช้เซสชันการนำทางที่ระบุ | |
ฟังก์ชันสมาชิกสาธารณะแบบคงที่ | |
(instancetype) | + mapWithFrame:camera: |
สร้างและแสดงผลมุมมองแผนที่ที่มีเฟรมและเป้าหมายกล้อง | |
(instancetype) | + mapWithFrame:mapID:camera: |
โปรแกรมเริ่มต้นที่สะดวกในการสร้างและแสดงผลมุมมองแผนที่พร้อมด้วยเฟรม รหัสแผนที่ และเป้าหมายกล้อง | |
ที่พัก | |
รหัส IBOutlet< GMSMapViewDelegate > | ตัวแทน |
ผู้ได้รับ GMSMapView | |
GMSCameraPosition * | กล้อง |
ควบคุมกล้องซึ่งกำหนดทิศทางแผนที่ | |
GMSProjection * | การคาดคะเน |
แสดงผลออบเจ็กต์ GMSProjection ที่คุณสามารถใช้เพื่อแปลงระหว่างพิกัดหน้าจอกับพิกัดละติจูด/ลองจิจูด | |
บูลีน | myLocationEnabled |
ควบคุมว่าจะเปิดใช้จุดตำแหน่งของฉันและวงกลมความแม่นยำหรือไม่ | |
CLLocation * | myLocation |
หากเปิดใช้งานตำแหน่งของฉัน จะแสดงตำแหน่งที่มีการวาดจุดตำแหน่งของอุปกรณ์ | |
GMSMarker * | selectedMarker |
เครื่องหมายที่เลือก | |
บูลีน | trafficEnabled |
ควบคุมว่าแผนที่จะดึงข้อมูลการจราจรหรือไม่ หากมี | |
GMSMapViewType | mapType |
ควบคุมประเภทของชิ้นส่วนแผนที่ที่ควรจะแสดง | |
GMSMapStyle * | mapStyle |
ควบคุมรูปแบบของแผนที่ | |
UIUserInterfaceStyle | overrideUserInterfaceStyle |
เปลี่ยนแผนที่เป็น [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc) ที่ต้องการ) | |
จำนวนลอยตัว | minZoom |
ระดับการซูมขั้นต่ำ (กล้องอาจซูมออกให้ไกลที่สุด) | |
จำนวนลอยตัว | maxZoom |
ซูมสูงสุด (กล้องอาจอยู่ใกล้กับโลกมากที่สุด) | |
บูลีน | buildingsEnabled |
หากตั้งค่าไว้ สิ่งปลูกสร้าง 3 มิติจะแสดงหากมี | |
บูลีน | indoorEnabled |
ตั้งค่าว่าจะแสดงแผนที่ในอาคารหรือไม่ (หากมี) | |
GMSIndoorDisplay * | indoorDisplay |
รับอินสแตนซ์ GMSIndoorDisplay ซึ่งช่วยในการสังเกตหรือควบคุมลักษณะการแสดงข้อมูลในอาคาร | |
GMSUISettings * | การตั้งค่า |
รับออบเจ็กต์ GMSUISettings ซึ่งควบคุมการตั้งค่าอินเทอร์เฟซผู้ใช้สำหรับแผนที่ | |
UIEdgeInsets | ระยะห่างจากขอบ |
ควบคุมการตั้งค่า "การมองเห็น" ของมุมมอง | |
GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
ควบคุมการเพิ่มพื้นที่ปลอดภัยในค่าระยะห่างจากขอบ | |
บูลีน | accessibilityElementsHidden |
ค่าเริ่มต้นคือ YES | |
GMSMapLayer * | เลเยอร์ |
ตัวเข้าถึงสำหรับประเภท CALayer ที่กำหนดเองซึ่งใช้สำหรับเลเยอร์ | |
GMSFrameRate | preferredFrameRate |
ควบคุมอัตราเฟรมในการแสดงผล | |
GMSCoordinateBounds * | cameraTargetBounds |
หากไม่ ให้จำกัดเป้าหมายของกล้องเพื่อไม่ให้ท่าทางสัมผัสหลุดออกจากขอบเขตที่ระบุ | |
GMSMapCapabilityFlags | mapCapabilities |
ความสามารถทั้งหมดที่พร้อมใช้งานแบบมีเงื่อนไข (ขึ้นอยู่กับรหัส MapID หรือการตั้งค่าแผนที่อื่นๆ) ที่พร้อมใช้งานในขณะนั้น | |
รหัส IBOutlet < GMSMapViewNavigationUIDelegate > | navigationUIDelegate |
ตัวแทนของ GMSMapView ซึ่งได้รับการติดต่อกลับสำหรับเหตุการณ์ UI การไปยังส่วนต่างๆ | |
บูลีน | navigationEnabled |
เปิดใช้ฟังก์ชันการนำทางสำหรับแผนที่นี้หรือไม่ | |
GMSNavigator * | ตัวนำทาง |
ตัวนำทางสำหรับ GMSMapView นี้ ซึ่งอนุญาตให้มีการขอเส้นทางและคำแนะนำแบบเลี้ยวต่อเลี้ยว | |
GMSRoadSnappedLocationProvider * | roadSnappedLocationProvider |
อนุญาตให้สมัครรับข้อมูลการอัปเดตตำแหน่งที่อยู่บนถนน | |
GMSLocationSimulator * | locationSimulator |
ให้คุณจำลองตำแหน่งอุปกรณ์ | |
GMSNavigationCameraMode | cameraMode |
โหมดของกล้องซึ่งจะกำหนดลักษณะการทำงานเมื่อตั้งค่าคุณสมบัติ NavigationEnabled เป็น YES | |
GMSNavigationCameraPerspective | followingPerspective |
มุมมองกล้องที่จะใช้เมื่อติดตามตำแหน่งของอุปกรณ์ | |
GMSNavigationTravelMode | travelMode |
โหมดการเดินทางซึ่งจะกำหนดประเภทเส้นทางที่จะดึงข้อมูลและวิธีกำหนดหลักสูตรของอุปกรณ์ | |
GMSNavigationLightingMode | lightingMode |
โหมดแสงจะเป็นตัวกำหนดรูปแบบสีที่จะใช้ในการแสดงภาพแผนที่ | |
บูลีน | shouldDisplaySpeedLimit |
กำหนดว่าควรแสดงขีดจำกัดความเร็วหรือไม่เมื่อมีการแสดงคำแนะนำ และมีข้อมูลขีดจำกัดความเร็ว | |
บูลีน | shouldDisplaySpeedometer |
ระบุว่าจะแสดงไอคอนมาตรวัดความเร็วหรือไม่ | |
คู่มือการออกแบบ UI * | navigationHeaderLayoutGuide |
สี่เหลี่ยมผืนผ้าที่ครอบคลุมโดยส่วนหัวของการนำทาง | |
คู่มือการออกแบบ UI * | navigationFooterLayoutGuide |
สี่เหลี่ยมผืนผ้าที่ครอบคลุมโดยส่วนท้ายของการนำทาง | |
GMSNavigationRouteCalloutFormat | routeCalloutFormat |
ระบุรูปแบบข้อความไฮไลต์สำหรับเส้นทาง (ค่าเริ่มต้น เวลา หรือระยะทาง) ที่จะใช้ | |
จำนวนลอยตัว | followingZoomLevel |
ระดับการซูมที่กำหนดเองระหว่างการนำทาง | |
GMSRoadSnappedLocationProvider * | roadSnappedMyLocationSource |
ตั้งค่าผู้ให้บริการตำแหน่งของฉันสำหรับมุมมองแผนที่นี้ | |
ฟังก์ชันที่เกี่ยวข้อง | |
(โปรดทราบว่าฟีเจอร์ดังกล่าวไม่ใช่ฟังก์ชันของสมาชิก) | |
NSString *const | kGMSAccessibilityCompass |
ตัวระบุการช่วยเหลือพิเศษสำหรับปุ่มเข็มทิศ | |
NSString *const | kGMSAccessibilityMyLocation |
ตัวระบุการช่วยเหลือพิเศษสำหรับ "ตำแหน่งของฉัน" | |
NSString *const | kGMSAccessibilityOutOfQuota |
ตัวระบุการช่วยเหลือพิเศษสำหรับ "หมดโควต้า" ป้ายกำกับข้อผิดพลาด |
เอกสารประกอบเกี่ยวกับฟังก์ชันของสมาชิก
- (instancetype) init |
เริ่มต้นด้วย CGRectZero และตัวเลือกเริ่มต้น
- (instancetype) initWithOptions: | (nonnull GMSMapViewOptions *) | ตัวเลือก |
สร้างมุมมองแผนที่ใหม่ตามตัวเลือกที่ให้ไว้
วิธีนี้จะคัดลอกค่าของออบเจ็กต์ตัวเลือก
- (instancetype) initWithFrame: | (CGRect) | เฟรม |
- (ประเภทอินสแตนซ์ที่เป็นค่าว่าง) initWithCoder: | (NSCoder *) | โปรแกรมเขียนโค้ด |
+ (ประเภทอินสแตนซ์) mapWithFrame: | (CGRect) | เฟรม | |
กล้อง: | (GMSCameraPosition *) | กล้อง | |
สร้างและแสดงผลมุมมองแผนที่ที่มีเฟรมและเป้าหมายกล้อง
+ (ประเภทอินสแตนซ์) mapWithFrame: | (CGRect) | เฟรม | |
mapID: | (GMSMapID *) | mapID | |
กล้อง: | (GMSCameraPosition *) | กล้อง | |
โปรแกรมเริ่มต้นที่สะดวกในการสร้างและแสดงผลมุมมองแผนที่พร้อมด้วยเฟรม รหัสแผนที่ และเป้าหมายกล้อง
- (instancetype) initWithFrame: | (CGRect) | เฟรม | |
กล้อง: | (GMSCameraPosition *) | กล้อง | |
สร้างและแสดงผลมุมมองแผนที่ โดยมีเฟรมและเป้าหมายกล้อง
- หมายเหตุ
- เลิกใช้งานแล้ว ให้ใช้ -init หรือ -initWithOptions: แทน
- (instancetype) initWithFrame: | (CGRect) | เฟรม | |
mapID: | (GMSMapID *) | mapID | |
กล้อง: | (GMSCameraPosition *) | กล้อง | |
สร้างและแสดงผลมุมมองแผนที่ที่มีเฟรม รหัสแผนที่ และเป้าหมายกล้อง
- หมายเหตุ
- เลิกใช้งานแล้ว ให้ใช้ -init หรือ -initWithOptions: แทน
- (เป็นโมฆะ) startRendering |
บอกให้แผนที่นี้เพิ่มประสิทธิภาพโหมดแสดงภาพ
วิธีนี้เป็นขั้นตอนที่ไม่บังคับและเป็นเอกลักษณ์
- หมายเหตุ
- เลิกใช้งานแล้ว วิธีนี้เก่าเกินไปและจะถูกนำออกในรุ่นถัดไป
- (เป็นโมฆะ) stopRendering |
บอกให้แผนที่นี้ปิดโหมดแสดงภาพ
วิธีนี้เป็นขั้นตอนที่ไม่บังคับและเป็นเอกลักษณ์
- หมายเหตุ
- เลิกใช้งานแล้ว วิธีนี้เก่าเกินไปและจะถูกนำออกในรุ่นถัดไป
- (โมฆะ) ล้าง |
ล้างมาร์กอัปทั้งหมดที่เพิ่มลงในแผนที่ รวมถึงเครื่องหมาย เส้นประกอบ และการวางซ้อนพื้น
การดำเนินการนี้จะไม่ล้างจุดตำแหน่งที่มองเห็นได้หรือรีเซ็ต MapType ปัจจุบัน
- (โมฆะ) setMinZoom: | (แบบลอย) | minZoom | |
maxZoom: | (แบบลอย) | maxZoom | |
ตั้งค่า minZoom
และ maxZoom
เมธอดนี้คาดว่าค่าต่ำสุดจะน้อยกว่าหรือเท่ากับค่าสูงสุด และจะส่งข้อยกเว้นที่มีชื่อ NSRangeException
- (GMSCameraPosition ที่เป็นค่าว่าง *) CameraForBounds: | (GMSCoordinateBounds *) | ขอบเขต | |
ส่วนที่แทรก: | (UIEdgeInsets) | ประกอบ | |
สร้าง GMSCameraPosition ที่นำเสนอ bounds
ด้วย padding
กล้องจะมีทิศทางและการเอียงเป็น 0 (นั่นคือ หันไปทางทิศเหนือและมองไปที่โลกโดยตรง) ซึ่งจะพิจารณาเฟรมและระยะห่างจากขอบของ GMSMapView นี้
หากขอบเขตไม่ถูกต้อง วิธีการนี้จะแสดงกล้องศูนย์
- (เป็นโมฆะ) moveCamera: | (GMSCameraUpdate *) | อัปเดต |
เปลี่ยนกล้องตามupdate
กล้องจะเปลี่ยนไปทันที (ไม่มีภาพเคลื่อนไหว)
- (BOOL) isEqualForRenderingPosition: | (GMSCameraPosition *) | ตำแหน่ง | |
ตำแหน่ง: | (GMSCameraPosition *) | otherPosition | |
ตรวจสอบว่าตำแหน่งกล้องที่ระบุจะทําให้กล้องแสดงผลเหมือนกันหรือไม่ โดยคํานึงถึงระดับความแม่นยําและการแปลงที่ใช้ภายใน
- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (ประเภทฟีเจอร์ GMS) | featureType |
แสดงผลเลเยอร์ฟีเจอร์ของประเภทที่ระบุ
คุณต้องกำหนดค่าเลเยอร์ของฟีเจอร์ใน Cloud Console
หากไม่มีเลเยอร์ประเภทที่ระบุบนแผนที่นี้ หรือหากไม่ได้เปิดใช้การจัดรูปแบบตามข้อมูล หรือหากไม่ได้ใช้เฟรมเวิร์กการแสดงผลโลหะ เลเยอร์ "isavailable" ของเลเยอร์ที่ได้จะเป็น NO
และจะไม่ตอบสนองต่อการเรียกใดๆ
ต้องใช้โหมดแสดงภาพโลหะ ดูวิธีเปิดใช้ Metal ได้ที่ https://developers.google.com/maps/documentation/ios-sdk/config#use-metal
- (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
แสดงผลเลเยอร์ฟีเจอร์ชุดข้อมูลของชุดข้อมูลที่ระบุ
ต้องกำหนดค่ารหัสชุดข้อมูลใน Cloud Console
หากไม่มีชุดข้อมูลของรหัสที่ระบุบนแผนที่นี้ หรือไม่ได้เปิดใช้การจัดรูปแบบตามข้อมูล ค่า "isavailable" ของเลเยอร์ผลลัพธ์จะเป็น NO
และจะไม่ตอบสนองต่อการเรียกใดๆ
- (โมฆะ) invalidateLayoutForAccessoryView: | (UIView< GMSNavigationAccessoryView > *) | accessoryView |
ทำให้มุมมองอุปกรณ์เสริมเป็นโมฆะและทริกเกอร์เลย์เอาต์ใหม่สำหรับมุมมองนั้น
มุมมองต้องเป็นหนึ่งในมุมมองอุปกรณ์เสริมปัจจุบัน หากไม่มีการใช้คำแนะนำ การโทรนี้เป็นคำสั่ง NO-OP
- (เป็นโมฆะ) setHeaderAccessoryView: | (nullable UIView< GMSNavigationAccessoryView > *) | headerAccessoryView |
กำหนดตำแหน่งของมุมมองอุปกรณ์เสริมใต้ส่วนหัวหลักของ UI การนำทาง
การส่งผ่านค่าศูนย์จะนำมุมมองอุปกรณ์เสริมออก หากไม่มีการใช้คำแนะนำ การโทรนี้เป็นคำสั่ง NO-OP
@note หากมุมมองแผนที่สั้น SDK จะซ่อนมุมมองอุปกรณ์เสริมเนื่องจากมีพื้นที่จำกัด มุมมองจะได้รับการจัดการภายในเพื่อเพิ่มประสิทธิภาพการแสดงแผนที่
- (เป็นโมฆะ) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
ทำให้กล้องของแผนที่นี้เคลื่อนไหวไปยัง cameraPosition
- (เป็นโมฆะ) animateToLocation: | (CLLocationCoordinate2D) | ตำแหน่ง |
เป็น AnimateToCameraPosition: แต่จะเปลี่ยนแปลงเฉพาะตําแหน่งของกล้อง (นั่นคือ จากตําแหน่งปัจจุบันเป็น location
)
- (โมฆะ) animateToZoom: | (แบบลอย) | ซูม |
เป็นภาพเคลื่อนไหว (เป็นภาพเคลื่อนไหว) แต่เปลี่ยนเฉพาะระดับการซูมของกล้อง
ค่านี้จะจำกัดโดย [kGMSMinZoomLevel, kGMSMaxZoomLevel]
- (โมฆะ) animateToBearing: | (CLLocationDirection) | การแบก |
เป็นภาพเคลื่อนไหว (เป็นองศา) แต่เปลี่ยนเฉพาะทิศทางของกล้องถ่ายรูป (เป็นองศา)
ศูนย์หมายถึงทิศเหนือจริง
- (โมฆะ) animateToViewingAngle: | (คู่) | viewingAngle |
เป็นภาพเคลื่อนไหว (เป็นองศา) แต่เปลี่ยนเฉพาะมุมการดูของกล้อง (เป็นองศา)
ค่านี้จะถูกบีบให้มีค่าต่ำสุดเป็น 0 (คว่ำลงแนวตรง) และระหว่าง 30-45 องศาให้แนวขอบฟ้า ขึ้นอยู่กับระยะใกล้โลกที่สัมพันธ์กับพื้นโลก
- (เป็นโมฆะ) animateWithCameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
ใช้ cameraUpdate
กับกล้องปัจจุบัน จากนั้นใช้ผลลัพธ์ตาม animateTocameraPosition:
- (โมฆะ) didBeginPanGesture |
ควรเรียกเมธอดนี้จากการใช้งานเมธอด CPMapTemplateDelegate -mapTemplateDidBeginPanGesture: ของแอปพลิเคชันเพื่อใช้ท่าทางสัมผัสการแพนสำหรับเทมเพลตแผนที่ CarPlay
- (โมฆะ) DidUpdatePanGestureWithTranslation: | (CGPoint) | การแปล | |
อัตราความเร็ว: | (CGPoint) | อัตราความเร็ว | |
ควรเรียกเมธอดนี้จากการใช้งานเมธอด CPMapTemplateDelegate -mapTemplate:didUpdatePanGestureWithTranslation ของแอปพลิเคชัน เพื่อใช้ท่าทางสัมผัสการแพนสำหรับเทมเพลตแผนที่ CarPlay
- (โมฆะ) didEndPanGestureWithVelocity: | (CGPoint) | อัตราความเร็ว |
ควรเรียกวิธีนี้จากการใช้งานแอปพลิเคชัน CPMapTemplateDelegate -mapTemplate:didEndPanGestureWithVelocity: เพื่อติดตั้งใช้งานท่าทางสัมผัสการแพนสำหรับเทมเพลตแผนที่ CarPlay
- (BOOL) enableNavigationWithSession: | (GMSNavigationSession *) | navigationSession |
เริ่มการนำทางในมุมมองแผนที่นี้โดยใช้เซสชันการนำทางที่ระบุ
- หมายเหตุ
- เพื่อการใช้หน่วยความจำและ CPU อย่างมีประสิทธิภาพมากที่สุด โปรดเรียกใช้เมธอดนี้ก่อนเรียกใช้วิธีการอื่นๆ ที่เกี่ยวข้องกับการนำทางในมุมมองแผนที่นี้
- การคืนสินค้า:
- หากการนำทางเริ่มต้นขึ้นเรียบร้อยแล้ว (เช่น ระบบจะแสดงผล NO ในกรณีที่ยังไม่ได้ยอมรับข้อกำหนดและเงื่อนไข)
เอกสารเกี่ยวกับเพื่อนและฟังก์ชันที่เกี่ยวข้อง
- (NSString* const) kGMSAccessibilityCompass [related] |
ตัวระบุการช่วยเหลือพิเศษสำหรับปุ่มเข็มทิศ
- (NSString* const) kGMSAccessibilityMyLocation [related] |
ตัวระบุการช่วยเหลือพิเศษสำหรับ "ตำแหน่งของฉัน"
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
ตัวระบุการช่วยเหลือพิเศษสำหรับ "หมดโควต้า" ป้ายกำกับข้อผิดพลาด
เอกสารเกี่ยวกับพร็อพเพอร์ตี้
- (IBOutlet id<GMSMapViewDelegate>) delegate [read, write, assign] |
ผู้ได้รับ GMSMapView
- (GMSCameraPosition*) กล้อง [read, write, copy] |
ควบคุมกล้องซึ่งกำหนดทิศทางแผนที่
การแก้ไขพร็อพเพอร์ตี้นี้มีผลทันที
- (GMSProjection*) การฉายภาพ [read, assign] |
แสดงผลออบเจ็กต์ GMSProjection ที่คุณสามารถใช้เพื่อแปลงระหว่างพิกัดหน้าจอกับพิกัดละติจูด/ลองจิจูด
นี่คือภาพรวมของการฉายภาพปัจจุบัน และจะไม่อัปเดตโดยอัตโนมัติเมื่อกล้องเคลื่อนที่ ค่านี้แสดงถึงเส้นโครงของเฟรม GMSMapView ที่วาดล่าสุด หรือ ในตำแหน่งที่กล้องได้รับการตั้งค่าอย่างชัดเจน หรือแผนที่เพิ่งสร้างขึ้น เฟรมต่อไป และจะไม่มีการใช้เลย
- (BOOL) myLocationEnabled [read, write, assign] |
ควบคุมว่าจะเปิดใช้จุดตำแหน่งของฉันและวงกลมความแม่นยำหรือไม่
ค่าเริ่มต้นคือ NO
- (CLLocation*) myLocation [read, assign] |
หากเปิดใช้งานตำแหน่งของฉัน จะแสดงตำแหน่งที่มีการวาดจุดตำแหน่งของอุปกรณ์
หากปิดใช้หรือเปิดใช้แต่ไม่มีข้อมูลตำแหน่ง พร็อพเพอร์ตี้นี้สังเกตการณ์ได้โดยใช้ KVO
- (GMSMarker*) selectedMarker [read, write, assign] |
เครื่องหมายที่เลือก
การตั้งค่านี้จะเลือกเครื่องหมายที่เฉพาะเจาะจงเพื่อแสดงหน้าต่างข้อมูลบนเครื่องหมายนั้น หากคุณสมบัตินี้ไม่ใช่ nil การตั้งค่าเป็น nil จะเป็นการยกเลิกการเลือกเครื่องหมาย ซึ่งจะซ่อนหน้าต่างข้อมูล พร็อพเพอร์ตี้นี้สังเกตการณ์ได้โดยใช้ KVO
- (BOOL) trafficEnabled [read, write, assign] |
ควบคุมว่าแผนที่จะดึงข้อมูลการจราจรหรือไม่ หากมี
ทั้งนี้ขึ้นอยู่กับความพร้อมใช้งานของข้อมูลการจราจร ค่าเริ่มต้นคือ NO
- (GMSMapViewType) mapType [read, write, assign] |
ควบคุมประเภทของชิ้นส่วนแผนที่ที่ควรจะแสดง
ค่าเริ่มต้นคือ kGMSTypeปกติ
- (GMSMapStyle*) mapStyle [read, write, assign] |
ควบคุมรูปแบบของแผนที่
รูปแบบแผนที่ที่ไม่ใช่ nil จะใช้ได้เมื่อ mapType เป็น "ปกติ" เท่านั้น
- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
เปลี่ยนแผนที่เป็น [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc) ที่ต้องการ)
ซึ่งจะลบล้างลักษณะการทำงานเริ่มต้นของ UIKit และกำหนดให้มีค่าเริ่มต้นเป็น UIUserInterfaceStyleLight เพื่อดูแลให้มีความเข้ากันได้แบบย้อนหลัง ส่วนนี้จะมีผลต่อรูปแบบสีของแผนที่ประเภทปกติและแผนที่ภูมิประเทศ
- (ลอย) minZoom [read, assign] |
ระดับการซูมขั้นต่ำ (กล้องอาจซูมออกให้ไกลที่สุด)
ค่าเริ่มต้นคือ kGMSMinZoomLevel แก้ไขด้วย -setMinZoom:maxZoom:.
- (แบบลอย) maxZoom [read, assign] |
ซูมสูงสุด (กล้องอาจอยู่ใกล้กับโลกมากที่สุด)
ค่าเริ่มต้นคือ kGMSMaxZoomLevel แก้ไขด้วย -setMinZoom:maxZoom:.
- (BOOL) buildingsEnabled [read, write, assign] |
หากตั้งค่าไว้ สิ่งปลูกสร้าง 3 มิติจะแสดงหากมี
ค่าเริ่มต้นคือ YES
สิ่งนี้อาจมีประโยชน์เมื่อเพิ่มเลเยอร์ของชิ้นส่วนที่กำหนดเองลงในแผนที่ เพื่อให้เข้าใจชัดเจนขึ้นในระดับการซูมสูง การเปลี่ยนค่านี้จะทำให้การ์ดทั้งหมดใช้งานไม่ได้เป็นเวลาสั้นๆ
- (BOOL) indoorEnabled [read, write, assign] |
ตั้งค่าว่าจะแสดงแผนที่ในอาคารหรือไม่ (หากมี)
ค่าเริ่มต้นคือ YES
หากตั้งค่าเป็น "ไม่" ระบบอาจลบแคชของข้อมูลในอาคารออกถาวรและรีเซ็ตชั้นใดๆ ที่ผู้ใช้ปลายทางเลือกไว้
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
รับอินสแตนซ์ GMSIndoorDisplay ซึ่งช่วยในการสังเกตหรือควบคุมลักษณะการแสดงข้อมูลในอาคาร
- (GMSUISettings*) การตั้งค่า [read, assign] |
รับออบเจ็กต์ GMSUISettings ซึ่งควบคุมการตั้งค่าอินเทอร์เฟซผู้ใช้สำหรับแผนที่
- ระยะห่างจากขอบ (UIEdgeInsets) [read, write, assign] |
ควบคุมการตั้งค่า "การมองเห็น" ของมุมมอง
การสร้างระยะห่างจากขอบของมุมมองสามารถสร้างได้ ซึ่งจะมีข้อมูลแผนที่แต่จะไม่มีตัวควบคุม UI
หากระยะห่างจากขอบไม่สมดุล จุดศูนย์กลางของมุมมองจะขยับตามความเหมาะสม Padding จะส่งผลต่อพร็อพเพอร์ตี้ projection
ด้วย ดังนั้นพื้นที่ที่มองเห็นได้จะไม่มีระยะห่างจากขอบ GMSCameraUpdate fitToBounds จะทำให้มั่นใจว่าระบบจะพิจารณาทั้งระยะห่างจากขอบนี้และระยะห่างจากขอบที่ขอ
คุณสมบัตินี้อาจเคลื่อนไหวได้ภายในบล็อกภาพเคลื่อนไหวที่ใช้ UIView
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
ควบคุมการเพิ่มพื้นที่ปลอดภัยในค่าระยะห่างจากขอบ
เช่นเดียวกับระยะห่างจากขอบ พื้นที่ที่ปลอดภัยจะระบุการควบคุมตำแหน่งบนแผนที่ เช่น เข็มทิศ ปุ่มตำแหน่งของฉัน และตัวเลือกชั้นภายในพื้นที่ปลอดภัยของอุปกรณ์
ค่าเริ่มต้นเป็น kGMSMapViewPaddingDeploymentBehavior Always
- (BOOL) accessibilityElementsHidden เพิ่มเติม
[read, write, assign] |
ค่าเริ่มต้นคือ YES
หากตั้งค่าเป็น "ไม่" GMSMapView จะสร้างองค์ประกอบการช่วยเหลือพิเศษสำหรับออบเจ็กต์ที่ซ้อนทับ เช่น GMSMarker และ GMSPolyline
พร็อพเพอร์ตี้นี้ใช้โปรโตคอล UIAccessibility อย่างไม่เป็นทางการ ยกเว้นค่าเริ่มต้น YES
- (GMSMapLayer*) เลเยอร์ [read, retain] |
ตัวเข้าถึงสำหรับประเภท CALayer ที่กำหนดเองซึ่งใช้สำหรับเลเยอร์
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
ควบคุมอัตราเฟรมในการแสดงผล
ค่าเริ่มต้นคือ kGMSFrameRateReach
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
หากไม่ ให้จำกัดเป้าหมายของกล้องเพื่อไม่ให้ท่าทางสัมผัสหลุดออกจากขอบเขตที่ระบุ
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
ความสามารถทั้งหมดที่พร้อมใช้งานแบบมีเงื่อนไข (ขึ้นอยู่กับรหัส MapID หรือการตั้งค่าแผนที่อื่นๆ) ที่พร้อมใช้งานในขณะนั้น
โดยไม่รวมความสามารถที่พร้อมใช้งานเสมอ
- (รหัส IBOutlet <GMSMapViewNavigationUIDelegate>) navigationUIDelegate [read, write, assign] |
ตัวแทนของ GMSMapView ซึ่งได้รับการติดต่อกลับสำหรับเหตุการณ์ UI การไปยังส่วนต่างๆ
- (BOOL) navigationEnabled [read, write, assign] คือ |
เปิดใช้ฟังก์ชันการนำทางสำหรับแผนที่นี้หรือไม่
หากเป็น "ใช่" เส้นทางและเส้นทางแบบเลี้ยวต่อเลี้ยวจะแสดงในแผนที่ได้ กล้องจะเข้าสู่โหมดต่อไปนี้ และปุ่มปรับกึ่งกลางใหม่จะปรากฏขึ้นเมื่อกล้องไม่ได้ติดตามตำแหน่งของอุปกรณ์
หากผู้ใช้ไม่ยอมรับข้อกำหนดในการให้บริการของ Google Navigation การตั้งค่าคุณสมบัตินี้จะไม่มีผลใดๆ หากต้องการแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข โปรดดูวิธีการใน GMSNavigationServices
- (GMSNavigator*) ตัวนำทาง [read, assign] |
ตัวนำทางสำหรับ GMSMapView นี้ ซึ่งอนุญาตให้มีการขอเส้นทางและคำแนะนำแบบเลี้ยวต่อเลี้ยว
หากผู้ใช้ไม่ยอมรับข้อกำหนดในการให้บริการของ Google การนำทาง ส่วนนี้จะไม่มีผล หากต้องการแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข โปรดดูวิธีการใน GMSNavigationServices
- (GMSRoadSnappedLocationProvider*) roadSnappedLocationProvider [read, assign] |
อนุญาตให้สมัครรับข้อมูลการอัปเดตตำแหน่งที่อยู่บนถนน
หากผู้ใช้ไม่ยอมรับข้อกำหนดในการให้บริการของ Google การนำทาง ส่วนนี้จะไม่มีผล หากต้องการแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข โปรดดูวิธีการใน GMSNavigationServices
- (GMSLocationSimulator*) locationSimulator [read, assign] |
ให้คุณจำลองตำแหน่งอุปกรณ์
ตำแหน่งจำลองจะส่งผลต่อตำแหน่งของเครื่องหมายรูปตัววีคว่ำบนแผนที่ ความคืบหน้าของคำแนะนำแบบเลี้ยวต่อเลี้ยว และการอัปเดตที่ได้รับจากผู้ให้บริการตำแหน่งสแนป
หากผู้ใช้ไม่ยอมรับข้อกำหนดในการให้บริการของ Google การนำทาง ส่วนนี้จะไม่มีผล หากต้องการแสดงกล่องโต้ตอบข้อกำหนดและเงื่อนไข โปรดดูวิธีการใน GMSNavigationServices
- (GMSNavigationCameraMode) cameraMode [read, write, assign] |
โหมดของกล้องซึ่งจะกำหนดลักษณะการทำงานเมื่อตั้งค่าคุณสมบัติ NavigationEnabled เป็น YES
ดูโหมดที่พร้อมใช้งานได้ที่ GMSNavigationCameraMode
- (GMSNavigationCameraPerspective) followingPerspective [read, write, assign] |
มุมมองกล้องที่จะใช้เมื่อติดตามตำแหน่งของอุปกรณ์
ต้องตั้งค่าพร็อพเพอร์ตี้ navigationEnabled
เป็น "ใช่" และต้องตั้งค่า cameraMode
เป็น GMSnavigationcameraModeมุ่งมั่นตามนี้เพื่อให้มุมมองนี้มีผล
- (GMSNavigationTravelMode) travelMode [read, write, assign] |
โหมดการเดินทางซึ่งจะกำหนดประเภทเส้นทางที่จะดึงข้อมูลและวิธีกำหนดหลักสูตรของอุปกรณ์
ในโหมดขับรถ เส้นทางของอุปกรณ์จะอิงตามทิศทางการเคลื่อนที่ ขณะที่อยู่ในโหมดปั่นจักรยานหรือเดิน เส้นทางจะยึดตามทิศทางเข็มทิศที่อุปกรณ์หันหน้าไป โดยหลักสูตรอุปกรณ์จะแสดงโดยทิศทางของเครื่องหมายระบุตำแหน่งของอุปกรณ์ และรายงานโดย GMSRoadSnappedLocationProvider
- (GMSNavigationLightingMode) lightingMode [read, write, assign] |
โหมดแสงจะเป็นตัวกำหนดรูปแบบสีที่จะใช้ในการแสดงภาพแผนที่
และยังใช้เพื่อกำหนดสีเริ่มต้นขององค์ประกอบอินเทอร์เฟซต่างๆ ด้วย
- (BOOL) shouldDisplaySpeedLimit [read, write, assign] |
กำหนดว่าควรแสดงขีดจำกัดความเร็วหรือไม่เมื่อมีการแสดงคำแนะนำ และมีข้อมูลขีดจำกัดความเร็ว
ค่าเริ่มต้นคือ NO
- (BOOL) shouldDisplaySpeedometer [read, write, assign] |
ระบุว่าจะแสดงไอคอนมาตรวัดความเร็วหรือไม่
เมื่อเปิดใช้ ไอคอนมาตรวัดความเร็วที่ระบุความเร็วของยานพาหนะจะปรากฏที่มุมด้านล่างระหว่างคำแนะนำ เมื่อมีข้อมูลขีดจำกัดความเร็วที่เชื่อถือได้ ไอคอนขีดจำกัดความเร็วจะปรากฏขึ้นด้วยและแนบอยู่กับไอคอนมาตรวัดความเร็ว ไอคอนมาตรวัดความเร็วอาจมีสีต่างๆ สำหรับข้อความและพื้นหลัง ทั้งนี้ขึ้นอยู่กับความรุนแรงของการแจ้งเตือนความเร็ว
หากเปิดใช้ปุ่มตั้งศูนย์กลางใหม่ ขีดจำกัดความเร็วและไอคอนมาตรวัดความเร็วจะซ่อนไว้ชั่วคราวเมื่อปุ่มล่าสุดแสดงขึ้น
- (UILayoutGuide*) navigationHeaderLayoutGuide [read, assign] |
สี่เหลี่ยมผืนผ้าที่ครอบคลุมโดยส่วนหัวของการนำทาง
ความสูงเป็น 0 เมื่อส่วนหัวถูกซ่อนไว้
- (UILayoutGuide*) navigationFooterLayoutGuide [read, assign] |
สี่เหลี่ยมผืนผ้าที่ครอบคลุมโดยส่วนท้ายของการนำทาง
ความสูงเป็น 0 เมื่อซ่อนส่วนท้ายไว้
- (GMSNavigationRouteCalloutFormat) routeCalloutFormat [read, write, assign] |
ระบุรูปแบบข้อความไฮไลต์สำหรับเส้นทาง (ค่าเริ่มต้น เวลา หรือระยะทาง) ที่จะใช้
- (ลอย) followingZoomLevel [read, write, assign] |
ระดับการซูมที่กำหนดเองระหว่างการนำทาง
การตั้งค่านี้จะลบล้างระดับการซูมเริ่มต้นของ Navigation SDK เมื่อกล้องติดตามตำแหน่งอุปกรณ์ (เช่น cameraMode
เท่ากับ GMSNavigationCameraModeFollowing
) ซึ่งอาจตั้งค่าเป็น GMSNavigationNoFollowingZoomLevel
หากไม่ควรใช้การลบล้างระดับการซูม
- (GMSRoadSnappedLocationProvider*) roadSnappedMyLocationSource [read, write, assign] |
ตั้งค่าผู้ให้บริการตำแหน่งของฉันสำหรับมุมมองแผนที่นี้
โดยปกติ จุดตำแหน่งของฉันและวงกลมความแม่นยำสำหรับมุมมองแผนที่จะขึ้นอยู่กับตำแหน่งจริงของอุปกรณ์ เมื่อตั้งค่าพร็อพเพอร์ตี้นี้ จุดตำแหน่งของฉันและวงกลมความแม่นยำจะขับเคลื่อนด้วยตำแหน่งสแนปจากผู้ให้บริการตำแหน่งที่ระบุแทน หากต้องการกลับสู่ลักษณะการทำงานปกติ ให้ตั้งค่าคุณสมบัตินี้เป็นศูนย์
การเลือกนี้จะไม่มีผลเมื่อ navigationEnabled
เปิดอยู่สำหรับมุมมองแผนที่นี้