Map
4 dk okuma
Map alanı bir yeri saklar: bir adres ve isteğe bağlı olarak koordinatları. Editörler bir adres arar, haritaya tıklar veya işaretçiyi sürükler; siteniz bir harita ve "View on map" bağlantısı gösterir.
Tür kimliği |
|
Sütun |
|
Döndürür | bir dizi: |
Yazdırır | adresi, bir haritayı ve "View on map" bağlantısını |
Ön yüz formları (Pro) | kullanılamaz |

JSON sütunu her zaman değerin tamamını tutar. İki yardımcı sütun, yazıları konuma göre filtreleyip sıralayabilmeniz için (örneğin "10 km içinde") her kayıtta otomatik doldurulur. Bu nedenle Map alanı olan bir grupta o alan için üç sütun bulunur.
Harita hizmetini seçin
Harita hizmeti, Massbase › Settings içindeki Maps kartından yapılan, site genelinde geçerli bir seçimdir.
Ayar | Etki |
|---|---|
Map provider | OpenStreetMap (ücretsiz, anahtar gerekmez) (varsayılan) veya Google Maps (API anahtarı). |
Google Maps API key | Google Maps için gösterilir. Maps JavaScript API ve Geocoding API etkinleştirilmiş bir tarayıcı anahtarı. Sayfa kaynağında göründüğü için Google Cloud konsolunda anahtarı sitenizle sınırlayın. Yalnızca harfler, rakamlar, |
Map ID | İsteğe bağlı. Google Cloud konsolundan alınan bir Map ID, haritaların Google'ın güncel işaretçilerini kullanmasını sağlar; yoksa Google'ın kullanımdan kaldırdığı klasik işaretçi kullanılır (en fazla 64 karakter). Map ID ayarlamanız önerilir. |
Bir Google anahtarı kaydedilene kadar, Google Maps seçili olsa bile "Until a key is saved, maps keep using OpenStreetMap." bildirimi geçerlidir ve OpenStreetMap kullanılmaya devam eder.
OpenStreetMap | Google Maps | |
|---|---|---|
Harita | OpenStreetMap karolarıyla Leaflet | Google Maps JavaScript API |
Adres arama | Nominatim (OpenStreetMap'in adres çözücüsü) | Google Geocoding |
Maliyet ve anahtar | Ücretsiz, anahtar gerekmez | Anahtar ve bir Google faturalandırma hesabı gerekir |
"View on map" bağlantısı | openstreetmap.org | google.com/maps |
OpenStreetMap kitaplığı yalnızca bir harita gerektirdiğinde indirilir. Editörlerin ve ziyaretçilerin tarayıcıları harita karolarını yüklemek için seçilen hizmete doğrudan bağlanır; editörlerin adres aramaları da adres çözücüye gönderilir. Bunu gizlilik politikanızda belirtin. OpenStreetMap hizmetleri herkese açıktır ve bir kullanım politikası vardır; çok yoğun siteler Google Maps veya kendi karo hizmetlerini kullanmalıdır.
Tür ayarları
Ayar | Varsayılan | Etki |
|---|---|---|
Initial latitude | boş | Henüz bir yer seçilmemişken haritanın açıldığı konum, örneğin |
Initial longitude | boş | Örneğin |
Zoom level | 13 | 1 (tüm dünya) ile 20 (tek bir bina) arasında. Başlangıç yakınlaştırması ve yeni değerlerin yakınlaştırması olarak kullanılır. |
Map height (px) | 320 | Haritanın düzenleme ekranındaki ve sitenizdeki yüksekliği, 120 ile 1000 arasında. |
Düzenleme ekranı
- Bir Search düğmesi olan bir adres kutusu (yer tutucu "Search for an address…"). Enter tuşuna veya Search düğmesine basın, ardından bir sonuç seçin.
- Bir harita. İşaretçiyi yerleştirmek için tıklayın veya işaretçiyi sürükleyin.
- Latitude ve Longitude kutularına yazabilirsiniz (enlem -90 ile 90, boylam -180 ile 180 arasında).
- Clear yeri kaldırır.
Editörün haritayı bıraktığı yakınlaştırma düzeyi değerle birlikte kaydedilir.
Kaydederken nelerin kabul edildiği
Bölüm | Kural |
|---|---|
| Düz metin, etiketler kaldırılır. |
| İki sayı da kendi aralığında olmalı, 7 ondalığa yuvarlanır. Biri eksikse veya aralık dışındaysa ikisi de atılır. |
| 1 ile 20 arasında; varsayılan olarak alanın Zoom level ayarıdır. |
Değer boş (null) sayılır, ancak yalnızca koordinat ve adres yoksa. Koordinatsız bir adres geçerli bir değerdir (lat ve lng değerleri null olur).
wpmcf_update_field() diziyi veya onun JSON dizesini alır. Düz bir "41.0,28.9" dizesi wpmcf_update_field() tarafından ayrıştırılmaz ve alanı temizler; yalnızca CSV içe aktarmaları lat,lng (ayrıca lat;lng) ve bir JSON nesnesi kabul eder.
Şablonda kullanım
$place = wpmcf_get_field( 'shop', 'location' );
// [
// 'address' => 'Istanbul',
// 'lat' => 41.0082,
// 'lng' => 28.9784,
// 'zoom' => 12,
// ]
$lat = wpmcf_get_field( 'shop', 'location', null, [ 'path' => 'lat' ] ); // 41.0082lat ve lng değerleri, yalnızca adresi olan bir değerde null olur. Kullanmadan önce kontrol edin:
if ( $place && null !== $place['lat'] ) {
printf( 'https://maps.example/?q=%s,%s', esc_attr( (string) $place['lat'] ), esc_attr( (string) $place['lng'] ) );
}Otomatik çıktı (wpmcf_the_field() ve shortcode):
[wpmcf_field group="shop" field="location" wrap="false"]<div class="wpmcf-map-field">
<p class="wpmcf-map-field__address">Istanbul</p>
<div class="wpmcf-map" data-lat="41.0082" data-lng="28.9784" data-zoom="12" data-height="320"
data-label="Istanbul" role="region" aria-label="Map of Istanbul"></div>
<a class="wpmcf-map-field__link" href="https://www.openstreetmap.org/?mlat=41.0082&mlon=28.9784#map=12/41.0082/28.9784">View on map</a>
</div><div class="wpmcf-map">öğesi, yalnızca Map alanı yazdıran sayfalarda yüklenen küçük bir betikle canlı bir haritaya dönüştürülür.- Adres var ancak koordinat yoksa yalnızca adres ve bir View on map bağlantısı (arama bağlantısı) yazdırılır; harita çizilmez.
- Bağlantı OpenStreetMap'e, sağlayıcı Google ise Google Maps'e gider.
Mesafeye göre arama: wpmcf_distance sorgu bağımsız değişkeni için wpmcf_query_posts() işlevine, Geliştirici API'si bölümünde bakın.
Sorun giderme
- Harita sitede boş görünüyor. Tarayıcı konsolunu kontrol edin. Google Maps için anahtar sitenizin alan adına ve Maps JavaScript API'ye izin vermelidir. Denemek için sağlayıcıyı OpenStreetMap olarak değiştirin.
- Adres araması hiçbir şey bulmuyor. Daha kısa bir adres deneyin veya işaretçiyi elle yerleştirin. Google ile anahtar için Geocoding API etkinleştirilmiş olmalıdır.
- Enlem ve boylam kayıtta kayboldu. Biri boştu veya aralık dışındaydı; ikisi birlikte atılır.
- Eski Google işaretçisi görünüyor. Map ID değerini Settings › Maps içine girin.
- Mevcut yazıların yeni sütunlarda koordinatı yok. Yardımcı sütunlar bir değer kaydedildiğinde doldurulur; bir alanı Map türüne değiştirdikten sonra yazıları yeniden kaydedin.
Hâlâ takıldınız mı? Destek ile iletişime geçin