بومی‌سازی نقشه

می‌توانید تنظیمات زبان و منطقه مورداستفاده در نقشه‌تان را با تغییر دادن تنظیمات زبان پیش‌فرض و کد منطقه نقشه سفارشی‌سازی کنید. این کار می‌تواند بر رفتار نقشه براساس کشور یا قلمرو مشخص‌شده تأثیر بگذارد.

پوشش «نقشه‌های سه‌بعدی» را در Maps JavaScript در جدول پوشش Maps مرور کنید.

بومی‌سازی زبان

به‌طور پیش‌فرض، Maps JavaScript API از تنظیمات زبانی که کاربر در مرورگر خود مشخص می‌کند استفاده می‌کند تا تعیین کند از کدام ترجمه نقشه استفاده کند. اما می‌توانید این مورد را تغییر دهید و زبان خاصی را برای استفاده تنظیم کنید. برای این کار، پارامتر language را هنگام ایجاد نقشه سه‌بعدی تنظیم کنید. زبان و منطقه را می‌توان پس‌از مقداردهی اولیه نقشه به‌روز کرد.

تنظیم پارامتر language بر زبانی که کنترل‌ها، نکته‌ابزارها، و اعلامیه‌های حق نشر در آن نمایش داده می‌شوند تأثیر می‌گذارد. این تنظیم بر ترجمه ویژگی‌های سیاسی، توصیف‌کننده‌ها، و ویژگی‌های طبیعی نیز تأثیر می‌گذارد؛ مثلاً «Geneva» را به «Genève» یا «lake» را به «lac» تغییر می‌دهد، یا جهت ارائه زبان را تغییر می‌دهد.

«نقشه‌های سه‌بعدی» در Maps JavaScript اولویت‌های بومی‌سازی را به‌ترتیب زیر جستجو می‌کند. اگر اولویت‌ها در مرحله اول تعریف نشده باشند، به جستجو در ترتیب مشخص‌شده ادامه می‌دهد. هرگونه دستورالعمل بومی‌سازی متناقض براساس اولویت تعریف‌شده در زیر حل‌وفصل می‌شود:

  1. تعریف Map3DElement. این اولین جایی است که «نقشه‌های سه‌بعدی» اولویت‌های بومی‌سازی را جستجو می‌کند.
  2. بارکننده Maps JavaScript API. از زبانی که هنگام بار کردن Maps JavaScript API مشخص شده است استفاده می‌شود.
  3. تنظیمات مرورگر و دامنه. از تنظیمات مرورگر برای زبان استفاده می‌شود، و از دامنه‌ای که Maps JavaScript API از آن بار شده است برای منطقه استفاده می‌شود.

مثال زیر نقشه‌ای را به زبان چینی نمایش می‌دهد و منطقه را روی چین تنظیم می‌کند:

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>

بومی‌سازی منطقه

پارامتر region می‌تواند کاشی‌های نقشه متفاوتی ارائه دهد یا برنامه را به‌سمت نتایج مناسب‌تر منطقه‌ای سوق دهد. علاوه‌براین، تنظیم برچسب منطقه تضمین می‌کند که برنامه با قوانین محلی مطابقت دارد، زیرا اطمینان حاصل می‌کند که بومی‌سازی منطقه‌ای صحیح برای کشوری که برنامه در آن میزبانی می‌شود اعمال شده است.