کاشی‌های ره‌نگاشت

کاشی‌های نقشه راه کاشی‌های تصویری براساس داده‌های توپوگرافی برداری با سبک نقشه‌نگاری Google هستند. این اطلاعات شامل جاده‌ها، ساختمان‌ها، مکان‌های جالب، و مرزهای سیاسی است.

درحال دریافت کاشی‌های ره‌نگاشت

پس‌از دریافت کد جلسه، می‌توانید درخواست‌های کاشی نقشه راه را شروع کنید. چون کد جلسه برای کل جلسه اعمال می‌شود، لازم نیست گزینه‌های نقشه را با درخواست‌های کاشی مشخص کنید.

نمونه کد زیر درخواست کد جلسه معمولی را برای کاشی‌های نقشه راه نشان می‌دهد.

curl -X POST -d '{
  "mapType": "roadmap",
  "language": "en-US",
  "region": "US"
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY"

کاشی‌های نقشه راه را با ایجاد درخواست HTTPS GET دریافت می‌کنید، همان‌طور که در مثال زیر نشان داده شده است.

curl "https://tile.googleapis.com/v1/2dtiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&orientation=0_or_90_or_180_or_270"

در این درخواست HTTPS GET،‏ z سطح بزرگ‌نمایی است (از ۰ تا ۲۲)، و x و y مختصات کاشی کاشی‌ای است که می‌خواهید بازیابی کنید.

پارامتر orientation اختیاری است. مقدار آن تعداد درجه چرخش تصویر کاشی در خلاف جهت عقربه‌های ساعت را مشخص می‌کند. orientation برای کاشی‌های roadmap پشتیبانی می‌شود و همچنین برای درخواست‌های ماهواره‌ای و زمین با تصاویر پایه حذف‌شده بااستفاده از "overlay": true و با تنظیم layerTypes پشتیبانی می‌شود. مقادیر معتبر orientation عبارت‌اند از ۰ (پیش‌فرض)، ۹۰، ۱۸۰، و ۲۷۰.

اگر مقدار orientation را اضافه کنید، شبکه مختصات کاشی نمی‌چرخد. برای مثال، اگر orientation را روی ۹۰ تنظیم کنید، مختصات x همچنان موقعیت چپ به راست کاشی را تعریف می‌کند که در این حالت از شمال به جنوب روی نقشه است.

جهت صفر درجه	جهت ۹۰ درجه

درخواست کاشی نمونه

نمونه زیر را درنظر بگیرید که یک کاشی تکی را درخواست می‌کند که حاوی کل جهان است. در این مثال، سطح بزرگ‌نمایی ۰ است و مختصات x و y برابر با ۰، ۰ است.

curl "https://tile.googleapis.com/v1/2dtiles/0/0/0?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY" --output /tmp/example_tile.png

در این مثال، پیام پاسخی از سرور وجود ندارد. درعوض، کاشی در فایل محلی با آمار زیر بارگیری می‌شود.

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  8335  100  8335    0     0  51471      0 --:--:-- --:--:-- --:--:-- 54835

برای کسب اطلاعات درباره سرصفحه‌های پیام پاسخ، به پیش‌واکشی، ذخیره در حافظه پنهان، یا ذخیره‌سازی محتوا مراجعه کنید.