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