کاشیهای نقشه راه، کاشیهای تصویری هستند که بر اساس دادههای توپوگرافی برداری و با استایل نقشهبرداری 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
سطح بزرگنمایی است (از 0 تا 22)، و x
و y
مختصات کاشی کاشی مورد نظر برای بازیابی هستند.
پارامتر orientation
اختیاری است. مقدار آن تعداد درجات چرخش عکس کاشی در خلاف جهت عقربه های ساعت را مشخص می کند. orientation
برای کاشیهای roadmap
پشتیبانی میشود، و همچنین برای درخواستهای ماهوارهای و زمینی با حذف تصاویر پایه با استفاده از "overlay": true
و با layerTypes
پشتیبانی میشود. مقادیر orientation
معتبر 0 (پیش فرض)، 90، 180 و 270 هستند.
اگر مقدار orientation
وارد کنید، شبکه مختصات کاشی چرخانده نمیشود. به عنوان مثال، اگر orientation
روی 90 تنظیم کنید، سپس مختصات x
همچنان موقعیت کاشی را از چپ به راست تعریف می کند، که در این مورد از شمال به جنوب در نقشه است.
جهت گیری صفر درجه | جهت 90 درجه |
---|---|
![]() | ![]() |
نمونه درخواست کاشی
مثال زیر را در نظر بگیرید که یک کاشی منفرد را درخواست می کند که کل جهان را در خود جای دهد. در این مثال، سطح زوم 0 است و مختصات x و y 0، 0 است.
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
برای اطلاعات در مورد سرصفحههای پیام پاسخ، به Pre-Fetching، Caching یا Storage of Content مراجعه کنید.