Title: Block for Apple Maps Author: 10up Published: 2020 年 6 月 26 日 Last modified: 2026 年 5 月 12 日 --- 搜索插件 ![](https://ps.w.org/maps-block-apple/assets/banner-772x250.png?rev=2357635) ![](https://ps.w.org/maps-block-apple/assets/icon-256x256.png?rev=2357635) # Block for Apple Maps 作者：[10up](https://profiles.wordpress.org/10up/) [下载](https://downloads.wordpress.org/plugin/maps-block-apple.1.1.5.zip) [实时预览](https://cn.wordpress.org/plugins/maps-block-apple/?preview=1) * [详情](https://cn.wordpress.org/plugins/maps-block-apple/#description) * [评价](https://cn.wordpress.org/plugins/maps-block-apple/#reviews) * [安装](https://cn.wordpress.org/plugins/maps-block-apple/#installation) * [开发进展](https://cn.wordpress.org/plugins/maps-block-apple/#developers) [支持](https://wordpress.org/support/plugin/maps-block-apple/) ## 描述 **Disclaimer:** _Apple Maps, MapKit JS, and the Apple logo are trademarks of Apple Inc. Apple Maps may not be available in all countries or regions._ This plugin integrates Apple’s [MapKit JS](https://developer.apple.com/maps/mapkitjs/) into an “Apple Maps” block in the WordPress block editor (Gutenberg). You will need an [Apple Developer Program](https://developer.apple.com/programs/) account, Maps Identifier, and Private Key to configure this plugin and connect to the MapKit JS API in order for the block to function. Note that the Apple Developer Program has an annual fee of 99 USD, in local currency where available. Prices may vary by region and are listed in local currency during the enrollment process. [Fee waivers are available for the Apple Developer Program for eligible organizations](https://developer.apple.com/support/membership-fee-waiver/). ### Configuration In order to start using the Apple Maps block, you will need to sign up for the Apple Developer Program and create your Maps identifiers, keys, and tokens. Follow the steps below to generate the Private Key, Key ID, and Team ID that you will need to configure the plugin and gain access to the MapKit JS API for the Apple Maps block. ### Create an Apple Developer account 1. If you don’t already have an Apple ID, then please [create an Apple ID](https://appleid.apple.com/account#!&page=create) as it is required in order to enroll in the Apple Developer Program in the next step. 2. [Enroll in the Apple Developer Program as either an individual or organization](https://developer.apple.com/programs/enroll/). Note that its possible to have an existing Apple Developer account but not be enrolled in the Apple Developer Program, so please be sure to complete the enrollment process in this step. 3. Sign the Apple Developer Program License Agreement in the [Agreements, Tax, and Banking section of App Store Connect](https://appstoreconnect.apple.com/WebObjects/iTunesConnect.woa/da/jumpTo?page=contracts). ### Create a Maps Identifier and Private Key 1. [Create a Maps ID and a MapKit JS Private Key](https://developer.apple.com/documentation/mapkitjs/creating_a_maps_identifier_and_a_private_key). 2. Copy the Private Key, paste it into the respective plugin setup field, and ensure the key includes the `-----BEGIN PRIVATE KEY-----` and `-----END PRIVATE KEY-----` lines. 3. Open the Key you created in Step 1, copy the `Key ID` value, and paste it into the respective plugin setup field. 4. Open the Identifier you created in Step 1, copy the `App ID Prefix` value (notice the value is appended with `(Team ID)`), and paste it into the respective plugin setup field. 5. Click the `Confirm MapKit Credentials` button in the plugin setup to gain access to the block options and begin customizing your Apple Maps block! ## 屏幕截图 [⌊Block settings⌉⌊Block settings⌉[ Block settings [⌊Block marker settings⌉⌊Block marker settings⌉[ Block marker settings [⌊Block initial install view showing MapKit JS credential fields⌉⌊Block initial install view showing MapKit JS credential fields⌉[ Block initial install view showing MapKit JS credential fields [⌊Block settings page showing MapKit JS credential fields⌉⌊Block settings page showing MapKit JS credential fields⌉[ Block settings page showing MapKit JS credential fields ## 区块 该插件提供了 1 个区块. * Apple Maps Add an Apple Map to your site. ## 安装 1. Install the plugin via the plugin installer, either by searching for it or uploading a .ZIP file. 2. Activate the plugin. 3. Follow the instructions to configure your accesss to the MapKit JS API. 4. Use Apple Maps for WordPress! ## 常见问题 ### I’m seeing validation errors when trying to authenticate my MapKit JS credentials, what am I doing wrong? If you have WordPress installed in a subdirectory, then there is a [known issue](https://github.com/10up/maps-block-apple/issues/34) specifically related to this setup where the WordPress Admin URL is different from the site URL. We’re working on a [minor release](https://github.com/10up/maps-block-apple/milestone/3) to resolve this issue. ### I want to update my MapKit JS credentials, what’s the best way to do this? Our recommendation on updating the Apple Maps block settings focuses on ensuring the best experience for your site users. Specifically we recommend the following approach to ensure that existing Apple Maps on your site continue to be displayed during your MapKit JS credential transition. 1. Create a new MapKit JS Private Key, Key ID, and/or Team ID. 2. Update the Apple Maps block settings with the newly created Private Key, Key ID, and/or Team ID. 3. Delete your old MapKit JS Private Key, Key ID, and/or Team ID. ### Are there any MapKit JS rate limits? There is a free daily limit of 250,000 map views and 25,000 service calls per the Apple Developer Program membership. For additional MapKit JS capacity needs you will need to [contact Apple directly](https://developer.apple.com/contact/request/mapkitjs/). ### Can I see how many map views and service requests are made to my MapKit JS Private Key? Yes, you can track your MapKit JS useage on the [MapKit JS Developer Dashboard](https://maps.developer.apple.com/). You can also monitor map initializations and service requests in realtime, or see up to a year of activity by day, week, month, or year via the MapKit JS Dashboard. ## 评价 ![](https://secure.gravatar.com/avatar/204fc3ef17b6af09ab23be9b86fd6502a2efb0bd80bcca492cac9eec8c978b56? s=60&d=retro&r=g) ### 󠀁[Clear Recommendation](https://wordpress.org/support/topic/clear-recommendation/)󠁿 [Anselm](https://profiles.wordpress.org/aurban/) 2022 年 10 月 12 日 1 回复 This plugin is awesome and exactly what I wanted to see. Setup is very easy. There’s a bug though: While setting up the Gutenberg block, error messages keep appearing on the bottom left of the screen. I’d like to have an option to display the map in dark mode. I know MapKit JS offers that. ![](https://secure.gravatar.com/avatar/6e5862026a2bb6ded2ddc52fe4df80146276f59d802f8f23bdba1e59d63ecc74? s=60&d=retro&r=g) ### 󠀁[Works Like it Should!](https://wordpress.org/support/topic/works-like-it-should-41/)󠁿 [aircmdr](https://profiles.wordpress.org/aircmdr/) 2020 年 8 月 6 日 1 回复 I have been using several different map plugins for my Wordpress site. All have had issues. I don’t want to use Google Maps, and the other plugins related to open maps I have looked at have limitations related to geolookups (particularly non-english locations) and marker placement. Having an easy way to embed Apple Maps on my Wordpress site is very helpful. Also like that I can place multiple markers on a map. [ 阅读所有2条评价 ](https://wordpress.org/support/plugin/maps-block-apple/reviews/) ## 贡献者及开发者 「Block for Apple Maps」是开源软件。 以下人员对此插件做出了贡献。 贡献者 * [ 10up ](https://profiles.wordpress.org/10up/) * [ Helen Hou-Sandi ](https://profiles.wordpress.org/helen/) * [ Ryan Welcher ](https://profiles.wordpress.org/welcher/) * [ Fabian Kaegy ](https://profiles.wordpress.org/fabiankaegy/) * [ Tung Du ](https://profiles.wordpress.org/dinhtungdu/) * [ Jeffrey Paul ](https://profiles.wordpress.org/jeffpaul/) [帮助将「Block for Apple Maps」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/maps-block-apple) ### 对开发感兴趣吗? 您可以[浏览代码](https://plugins.trac.wordpress.org/browser/maps-block-apple/)， 查看[SVN仓库](https://plugins.svn.wordpress.org/maps-block-apple/)，或通过[RSS](https://plugins.trac.wordpress.org/log/maps-block-apple/?limit=100&mode=stop_on_copy&format=rss) 订阅[开发日志](https://plugins.trac.wordpress.org/log/maps-block-apple/)。 ## 更新日志 #### 1.1.5 – 2025-07-14 * **Note that this release bumps the WordPress minimum version from 6.4 to 6.6.** * **Changed:** Bump WordPress “tested up to” version 6.8 (props [@sudip-md](https://github.com/sudip-md), [@mehidi258](https://github.com/mehidi258), [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter), [@peterwilsoncc](https://github.com/peterwilsoncc), [@Rishabh-fueled](https://github.com/@Rishabh-fueled) via [#229](https://github.com/10up/maps-block-apple/pull/229), [#230](https://github.com/10up/maps-block-apple/pull/230), [#237](https://github.com/10up/maps-block-apple/pull/237), [#238](https://github.com/10up/maps-block-apple/pull/238)). * **Changed:** Bump WordPress minimum supported version to 6.6 (props [@sudip-md](https://github.com/sudip-md), [@mehidi258](https://github.com/mehidi258), [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter), [@peterwilsoncc](https://github.com/peterwilsoncc), [@Rishabh-fueled](https://github.com/@Rishabh-fueled) via [#229](https://github.com/10up/maps-block-apple/pull/229), [#230](https://github.com/10up/maps-block-apple/pull/230), [#238](https://github.com/10up/maps-block-apple/pull/238)). * **Fixed:** Block crash when no Apple Maps credentials are configured (props [@elvismdev](https://github.com/elvismdev), [@peterwilsoncc](https://github.com/peterwilsoncc) via [#233](https://github.com/10up/maps-block-apple/pull/233)). * **Security:** Bump `braces` from 3.0.2 to 3.0.3, `express` from 4.18.2 to 4.19.2,` webpack` from 5.89.0 to 5.94.0 and `webpack-dev-middleware` from 5.3.3 to 5.3.4( props [@dependabot](https://github.com/apps/dependabot), [@faisal-alvi](https://github.com/faisal-alvi) via [#224](https://github.com/10up/maps-block-apple/pull/224)). * **Security:** Bump `@wordpress/scripts` from 27.9.0 to 30.6.0, `body-parser` from 1.20.2 to 1.20.3, `express` from 4.19.2 to 4.21.1, `ws` from 7.5.9 to 8.18.0,` send` from 0.18.0 to 0.19.0 and `serve-static` from 1.15.0 to 1.16.2 (props [@dependabot](https://github.com/apps/dependabot), [@peterwilsoncc](https://github.com/peterwilsoncc) via [#231](https://github.com/10up/maps-block-apple/pull/231)). * **Security:** Bump `@wordpress/e2e-test-utils-playwright` from 1.13.0 to 1.18.0,` serialize-javascript` from 6.0.1 to 6.0.2, `mocha` from 10.2.0 to 11.1.0 and removes `cookie` (props [@dependabot](https://github.com/apps/dependabot), [@peterwilsoncc](https://github.com/peterwilsoncc) via [#234](https://github.com/10up/maps-block-apple/pull/234)). * **Security:** Bump `axios` from 1.7.4 to 1.9.0 and `http-proxy-middleware` from 2.0.6 to 2.0.9 (props [@dependabot](https://github.com/apps/dependabot), [@peterwilsoncc](https://github.com/peterwilsoncc) via [#241](https://github.com/10up/maps-block-apple/pull/241)). #### 1.1.4 – 2024-08-22 * **Note that this release bumps the WordPress minimum version from 5.8 to 6.4.** * **Changed:** Update the `apiVersion` of the Apple Maps Block to Version 3 (props [@fabiankaegy](https://github.com/fabiankaegy), [@wadebekker](https://github.com/wadebekker), [@dkotter](https://github.com/dkotter) via [#211](https://github.com/10up/maps-block-apple/pull/211)). * **Changed:** Bump WordPress “tested up to” version to 6.6 (props [@QAharshalkadu](https://github.com/QAharshalkadu), [@sudip-md](https://github.com/sudip-md), [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter) via [#212](https://github.com/10up/maps-block-apple/pull/212), [#218](https://github.com/10up/maps-block-apple/pull/218)). * **Changed:** Bump minimum WordPress version from 5.8 to 6.4 (props [@QAharshalkadu](https://github.com/QAharshalkadu), [@sudip-md](https://github.com/sudip-md), [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter) via [#212](https://github.com/10up/maps-block-apple/pull/212), [#218](https://github.com/10up/maps-block-apple/pull/218)). * **Fixed:** Load the Apple MapKit script in the editor iframe to ensure the Apple Maps block works correctly (props [@fabiankaegy](https://github.com/fabiankaegy), [@wadebekker](https://github.com/wadebekker), [@dkotter](https://github.com/dkotter) via [#211](https://github.com/10up/maps-block-apple/pull/211)). * **Security:** Bump `postcss` from 8.4.23 to 8.4.32 (props [@dependabot](https://github.com/apps/dependabot), [@faisal-alvi](https://github.com/faisal-alvi) via [#194](https://github.com/10up/maps-block-apple/pull/194)). * **Security:** Bump `@babel/traverse` from 7.21.5 to 7.23.7 (props [@dependabot](https://github.com/apps/dependabot), [@peterwilsoncc](https://github.com/peterwilsoncc) via [#200](https://github.com/10up/maps-block-apple/pull/200)). * **Security:** Bump `axios` from 0.25.0 to 1.7.4, `@wordpress/scripts` from 24.6.0 to 27.5.0, `express` from 4.18.2 to 4.19.2, `follow-redirects` from 1.15.3 to 1.15.6 and `webpack-dev-middleware` from 5.3.3 to 5.3.4 (props [@dependabot](https://github.com/apps/dependabot), [@Sidsector9](https://github.com/Sidsector9) via [#209](https://github.com/10up/maps-block-apple/pull/209), [#219](https://github.com/10up/maps-block-apple/pull/219)). * **Security:** Bump `braces` from 3.0.2 to 3.0.3 and `ws` from 7.5.9 to 7.5.10( props [@dependabot](https://github.com/apps/dependabot), [@iamdharmesh](https://github.com/iamdharmesh) via [#215](https://github.com/10up/maps-block-apple/pull/215)). * **Developer:** Support for the WordPress.org plugin preview (props [@dkotter](https://github.com/dkotter), [@jeffpaul](https://github.com/jeffpaul) via [#196](https://github.com/10up/maps-block-apple/pull/196)). #### Earlier versions For the changelog of earlier versions, please refer to the [changelog on github.com](https://github.com/10up/maps-block-apple/blob/develop/CHANGELOG.md). ## 社区插件 该插件由社区开发和支持。 [为该插件贡献](https://github.com/10up/maps-block-apple) ## 额外信息 * 版本 **1.1.5** * 最后更新：**1 月前** * 活跃安装数量 **1,000+** * WordPress 版本 ** 6.6 或更高版本 ** * 已测试的最高版本为 **7.0** * PHP 版本 ** 7.4 或更高版本 ** * 语言 * [English (US)](https://wordpress.org/plugins/maps-block-apple/) * 标签 * [block](https://cn.wordpress.org/plugins/tags/block/)[map block](https://cn.wordpress.org/plugins/tags/map-block/) * [高级视图](https://cn.wordpress.org/plugins/maps-block-apple/advanced/) ## 评级 5 星（最高 5 星）。 * [ 2 条 5 星评价 ](https://wordpress.org/support/plugin/maps-block-apple/reviews/?filter=5) * [ 0 条 4 星评价 ](https://wordpress.org/support/plugin/maps-block-apple/reviews/?filter=4) * [ 0 条 3 星评价 ](https://wordpress.org/support/plugin/maps-block-apple/reviews/?filter=3) * [ 0 条 2 星评价 ](https://wordpress.org/support/plugin/maps-block-apple/reviews/?filter=2) * [ 0 条 1 星评价 ](https://wordpress.org/support/plugin/maps-block-apple/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/maps-block-apple/reviews/#new-post) [查看全部评论](https://wordpress.org/support/plugin/maps-block-apple/reviews/) ## 贡献者 * [ 10up ](https://profiles.wordpress.org/10up/) * [ Helen Hou-Sandi ](https://profiles.wordpress.org/helen/) * [ Ryan Welcher ](https://profiles.wordpress.org/welcher/) * [ Fabian Kaegy ](https://profiles.wordpress.org/fabiankaegy/) * [ Tung Du ](https://profiles.wordpress.org/dinhtungdu/) * [ Jeffrey Paul ](https://profiles.wordpress.org/jeffpaul/) ## 支持 有话要说吗？是否需要帮助？ [查看支持论坛](https://wordpress.org/support/plugin/maps-block-apple/)