Tổng quan
Yêu cầu đối tượng sử dụng với GMSPlacesClient
để tìm nạp địa điểm lân cận.
Hàm thành phần công khai | |
(instancetype) | – initWithLocationRestriction:placeProperties: |
Tạo thực thể cho GMSPlaceSearchNearbyRequest có giới hạn về vị trí và các thuộc tính địa điểm cần trả về. | |
Tài sản | |
mã nhận dạng< GMSPlaceLocationRestriction > | locationRestriction |
Không sử dụng được init mặc định. | |
NSArray< GMSPlaceProperty > * | placeProperties |
Mảng GMSPlaceProperty cần được đưa vào kết quả về địa điểm. | |
NSArray< NSString * > * | includedTypes |
Mảng các loại địa điểm để đưa vào một nội dung tìm kiếm. | |
NSArray< NSString * > * | excludedTypes |
Mảng các loại địa điểm cần loại trừ khỏi nội dung tìm kiếm. | |
NSArray< NSString * > * | includedPrimaryTypes |
Mảng của các loại địa điểm chính để đưa vào một nội dung tìm kiếm. | |
NSArray< NSString * > * | excludedPrimaryTypes |
Mảng gồm các loại địa điểm chính cần loại trừ khỏi nội dung tìm kiếm. | |
NSInteger | maxResultCount |
Số lượng kết quả tối đa GMSPlace cần trả về. | |
NSString * | regionCode |
Mã quốc gia/khu vực Unicode (CLDR) của vị trí gửi yêu cầu. | |
GMSPlaceSearchNearbyRankPreference | rankPreference |
GMSPlaceSearchNearbyRankPreference dùng để sắp xếp kết quả được trả về từ yêu cầu. |
Tài liệu về chức năng của thành viên
- (instancetype) initWithLocationRestriction: | (id< GMSPlaceLocationRestriction >) | locationRestriction | |
placeProperties: | (NSArray< GMSPlaceProperty > *) | placeProperties | |
Tạo thực thể cho GMSPlaceSearchNearbyRequest
có giới hạn về vị trí và các thuộc tính địa điểm cần trả về.
- Các tham số:
-
locationRestriction Vùng để tìm kiếm được chỉ định dưới dạng một hình tròn, được xác định bởi điểm tâm và bán kính tính bằng mét. placeProperties Mảng GMSPlaceProperty
cần được đưa vào kết quả về địa điểm. Không được để trống. Danh sách trống sẽ dẫn đến lỗi khi cố gắng gửi yêu cầu.
Tài liệu về thuộc tính
– (id<GMSPlaceLocationRestriction>) locationRestriction [read, write, copy] |
Không sử dụng được init mặc định.
Vui lòng sử dụng trình khởi tạo được chỉ định. Vùng để tìm kiếm được chỉ định dưới dạng một hình tròn, được xác định bởi điểm tâm và bán kính tính bằng mét. Bán kính phải nằm trong khoảng từ 0,0 đến 50000,0, bao gồm cả hai giá trị đó. Việc phá vỡ giới hạn này sẽ dẫn đến lỗi INVALID_ARGUMENT. Vị trí hạn chế phải được chỉ định bằng GMSPlaceCircularLocationOption
. Sử dụng GMSPlaceRectangularLocationOption
sẽ dẫn đến lỗi INVALID_REQUEST.
– (NSArray<GMSPlaceProperty>*) placeProperties [read, write, copy] |
Mảng GMSPlaceProperty
cần được đưa vào kết quả về địa điểm.
Không được để trống. Danh sách trống sẽ dẫn đến lỗi khi cố gắng gửi yêu cầu.
– (NSArray<NSString *>*) includedTypes [read, write, copy] |
Mảng các loại địa điểm để đưa vào một nội dung tìm kiếm.
Bạn có thể chỉ định tối đa 50 loại. Nếu một yêu cầu được chỉ định với nhiều hạn chế về loại, thì chỉ những vị trí đáp ứng tất cả các hạn chế đó mới được trả về. Nếu mảng trống thì hàm trả về tất cả các vị trí thuộc mọi loại. Xem Bảng A để biết danh sách các loại được hỗ trợ https://developers.google.com/maps/documentation/places/web-service/place-types#table-a.
– (NSArray<NSString *>*) excludedTypes [read, write, copy] |
Mảng các loại địa điểm cần loại trừ khỏi nội dung tìm kiếm.
Bạn có thể chỉ định tối đa 50 loại. Nếu một yêu cầu được chỉ định với nhiều hạn chế về loại, thì chỉ những vị trí đáp ứng tất cả các hạn chế đó mới được trả về. Nếu các loại xung đột được chỉ định (ví dụ: các loại xuất hiện trong includesTypes và excludedTypes), lỗi INVALID_REQUEST sẽ được trả về. Xem Bảng A để biết danh sách các loại được hỗ trợ https://developers.google.com/maps/documentation/places/web-service/place-types#table-a.
– (NSArray<NSString *>*) includedPrimaryTypes [read, write, copy] |
Mảng của các loại địa điểm chính để đưa vào một nội dung tìm kiếm.
Bạn có thể chỉ định tối đa 50 loại. Nếu một yêu cầu được chỉ định với nhiều hạn chế về loại, thì chỉ những vị trí đáp ứng tất cả các hạn chế đó mới được trả về. Để biết thêm thông tin về các loại chính, hãy xem: https://developers.google.com/maps/documentation/places/web-service/nearby-search#includedtypesexcludedtypes,-includedprimarytypesexcludedprimarytypes
– (NSArray<NSString *>*) excludedPrimaryTypes [read, write, copy] |
Mảng gồm các loại địa điểm chính cần loại trừ khỏi nội dung tìm kiếm.
Nếu các loại xung đột được chỉ định (ví dụ: các loại xuất hiện trong includesTypes và excludedTypes), lỗi INVALID_REQUEST sẽ được trả về. Bạn có thể chỉ định tối đa 50 loại. Nếu một yêu cầu được chỉ định với nhiều hạn chế về loại, thì chỉ những vị trí đáp ứng tất cả các hạn chế đó mới được trả về. Để biết thêm thông tin về các loại chính, hãy xem: https://developers.google.com/maps/documentation/places/web-service/nearby-search#includedtypesexcludedtypes,-includedprimarytypesexcludedprimarytypes
– (NSInteger) maxResultCount [read, write, assign] |
Số lượng kết quả tối đa GMSPlace
cần trả về.
Giá trị phải nằm trong khoảng từ 1 đến 20 (mặc định). Nếu bạn vi phạm quy định hạn chế này, một thông báo lỗi sẽ được trả về.
– (NSString*) regionCode [read, write, copy] |
Mã quốc gia/khu vực Unicode (CLDR) của vị trí gửi yêu cầu.
Hãy tham khảo https://www.unicode.org/cldr/charts/44/supplemental/territory_language_information.html để biết mã vùng.
– (GMSPlaceSearch nearby{/3}Preferences) rankPreference [read, write, assign] không |
GMSPlaceSearchNearbyRankPreference
dùng để sắp xếp kết quả được trả về từ yêu cầu.
Giá trị mặc định là GMSPlaceSearchNearbyRankPopularity
.