acf/fields/google_map/api

Описание

Используется для изменения параметров URL, применяемых при загрузке Google Maps JS API.

В основном этот фильтр предназначен для задания ключа Google API, однако его также можно использовать для настройки other_params, применяемых в функции google.load.

История изменений

  • Добавлен в версии 5.3.10

Параметры

apply_filters( 'acf/fields/google_map/api', $args );

$args

(array) Массив параметров URL.
– libraries
(string) Разделённый запятыми список библиотек для загрузки. По умолчанию — “places”.
~~~
‘libraries’ => ‘places’,
~~~

  • key
    (string) Ключ API Google Maps. По умолчанию используется пустая строка.

    'key' => '',
    
  • client
    (string) Необязательный параметр. Идентификатор клиента Google API. По умолчанию используется пустая строка.

    'client' => '',
    
  • callback
    (string) Необязательный параметр. Глобальная функция JavaScript, вызываемая после загрузки API. По умолчанию используется Function.prototype (функция без действий).

    'callback' => 'Function.prototype',
    

Пример

В этом примере показано, как зарегистрировать ключ Google API, который будет использоваться при загрузке библиотеки Google Maps JS.

functions.php

<?php
add_filter('acf/fields/google_map/api', 'my_acf_google_map_api');
function my_acf_google_map_api( $args ) {
    $args['key'] = 'xxx';
    return $args;
}

Обновлено: 30.09.2026