yunusga/carbon-field-map-yandex

Carbon Fields 扩展,增加了 Map Yandex 字段类型。

v1.1.1 2022-06-25 06:17 UTC

This package is auto-updated.

Last update: 2024-09-25 11:59:29 UTC


README

地图字段提供由 Yandex 提供支持的地图,并为 Carbon Fields 提供地址搜索字段。

Field::make( 'map_yandex', 'crb_map', __( 'Yandex Map' ) )

通过 Composer 安装

composer require yunusga/carbon-field-map-yandex

信息

该字段存储几块相关联的信息

Yandex Maps JS Key 设置

截至 2018 年 10 月 11 日,Yandex 要求用户生成一个 API 密钥才能使用 Yandex Maps API:https://yandex.ru/blog/mapsapi/novye-pravila-dostupa-k-api-kart?from=club

您可以在这里获取您的 API 密钥:https://developer.tech.yandex.ru/services/3/

一旦您完成了密钥生成过程,您需要通过过滤器将密钥提供给 Carbon Fields

/**
 * Provide the Yandex Maps API key to Carbon Fields
 * 
 * @param string $key Yandex JS API key.
 */
function crb_get_yandex_maps_api_key( $key ) {
	return 'your key goes here';
}
add_filter( 'carbon_fields_map_yandex_field_api_key', 'crb_get_yandex_maps_api_key' );

配置方法

set_position( $lat, $lng, $zoom )

通过 $lat$lng 设置地图上的默认位置,以及默认缩放级别到 $zoom(缩放 0 对应于完全缩出的地球地图)。

Field::make( 'map_yandex', 'crb_company_location', __( 'Location' ) )
	->set_help_text( __( 'drag and drop the pin on the map to select location' ) )

用法

要获取所有位置数据作为一个数组,您可以在检索函数中使用 map_yandex 类型。示例

// Get the location data.
$map_yandex = carbon_get_post_meta( $post_id, $field_name );

值格式

array(
	'value'   => '11.370946,142.591472',
	'lat'     => 11.370946,
	'lng'     => 142.591472,
	'zoom'    => 4,
	'address' => 'The lowest point of the Mariana Trench',
)