Haritayı yerelleştirme

Varsayılan dil ayarlarını ve haritanın bölge kodunu değiştirerek haritanızda kullanılan dil ve bölge ayarlarını özelleştirebilirsiniz. Bu, haritanın davranışını belirtilen ülke veya bölgeye göre etkileyebilir.

Maps JavaScript API'deki 3D haritaların kapsamını Haritalar kapsam tablosunda inceleyin.

Dil yerelleştirmesi

Maps JavaScript API, haritanın hangi çevirisinin kullanılacağını belirlemek için varsayılan olarak kullanıcının tarayıcısında belirttiği dil ayarlarını kullanır. Ancak bu ayarı değiştirebilir ve 3D harita oluştururken language parametresini ayarlayarak kullanılacak belirli bir dil belirleyebilirsiniz. Harita başlatıldıktan sonra dil ve bölge güncellenebilir.

language parametresinin ayarlanması; kontrollerin, ipuçlarının ve telif hakkı bildirimlerinin gösterildiği dili etkiler. Ayrıca, siyasi özelliklerin, tanımlayıcıların ve doğal özelliklerin çevirisini de etkiler. Örneğin, "Geneva"yı "Genève" veya "lake"i "lac" olarak değiştirebilir ya da dilin oluşturulduğu yönü değiştirebilir.

Maps JavaScript'teki 3D Haritalar, yerelleştirme tercihlerini aşağıdaki sırayla arar. İlk adımda tercihler tanımlanmamışsa belirtilen sırayla aramaya devam eder. Çakışan yerelleştirme talimatları, aşağıda tanımlanan öncelik sırasına göre çözümlenir:

  1. Map3DElement tanımı. 3D Haritalar, yerelleştirme tercihlerini ilk olarak burada arar.
  2. Maps JavaScript API yükleyicisi. Maps JavaScript API yüklenirken belirtilen dil kullanılır.
  3. Tarayıcı ayarı ve alan. Dil için tarayıcı ayarı, bölge için ise Maps JavaScript API'nin yüklendiği alan kullanılır.

Aşağıdaki örnekte, harita Çince olarak gösterilir ve bölge Çin olarak ayarlanır:

TypeScript

async function init() {
    const { Map3DElement } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
        center: {
            lat: 49.75371685807847,
            lng: -123.13227141171181,
            altitude: 30,
        },
        tilt: 50.64793990040634,
        heading: 44.480020261589154,
        range: 51618.36056532338,
        language: 'ZH',
        region: 'CN',
        mode: 'HYBRID',
    });

    document.body.append(map);
}

void init();

JavaScript

async function init() {
    const { Map3DElement } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
        center: {
            lat: 49.75371685807847,
            lng: -123.13227141171181,
            altitude: 30,
        },
        tilt: 50.64793990040634,
        heading: 44.480020261589154,
        range: 51618.36056532338,
        language: 'ZH',
        region: 'CN',
        mode: 'HYBRID',
    });

    document.body.append(map);
}

void init();

CSS

/* 
 * Always set the map height explicitly to define the size of the div element
 * that contains the map. 
 */
#gmp-map-3d {
    height: 100%;
}
html,
body {
    height: 100%;
    margin: 0;
    padding: 0;
}

HTML

<html>
    <head>
        <title>3d localization</title>

        <link rel="stylesheet" type="text/css" href="./style.css" />
        <script type="module" src="./index.js"></script>
        <script>
            // prettier-ignore
            (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
                key: "GOOGLE_MAPS_API_KEY"
            });
        </script>
    </head>
    <body></body>
</html>

Bölge yerelleştirmesi

region parametresi, farklı harita parçaları sunabilir veya uygulamayı daha bölgesel olarak uygun sonuçlara yönlendirebilir. Ayrıca bölge etiketinin ayarlanması, uygulamanın barındırıldığı ülkeye doğru bölgesel yerelleştirmenin uygulanmasını sağlayarak uygulamanın yerel yasalara uymasını sağlar.