کاشیهای نقشه راه، کاشیهای تصویری مبتنی بر دادههای توپوگرافی برداری با سبک نقشهبرداری گوگل هستند. این شامل جادهها، ساختمانها، نقاط مورد علاقه و مرزهای سیاسی میشود.
دریافت کاشیهای نقشه راه
شما میتوانید پس از دریافت توکن جلسه، درخواستهای مربوط به کاشی نقشه راه را آغاز کنید. از آنجا که توکن جلسه برای کل جلسه اعمال میشود، لازم نیست گزینههای نقشه را با درخواستهای کاشی خود مشخص کنید.
نمونه کد زیر یک درخواست توکن نشست معمولی برای کاشیهای نقشه راه را نشان میدهد.
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 عبارتند از 0 (پیشفرض)، 90، 180 و 270.
اگر مقدار orientation وارد کنید، شبکه مختصات کاشی چرخانده نمیشود. برای مثال، اگر orientation روی ۹۰ تنظیم کنید، مختصات x همچنان موقعیت چپ به راست کاشی را مشخص میکند که در این حالت از شمال به جنوب روی نقشه است.
| جهتگیری صفر درجه | جهت گیری ۹۰ درجه |
|---|---|
نمونه درخواست کاشی
مثال زیر را در نظر بگیرید که یک کاشی واحد را درخواست میکند که شامل کل جهان است. در این مثال، سطح بزرگنمایی 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
برای اطلاعات مربوط به هدرهای پیام پاسخ، به پیشواکشی، ذخیرهسازی یا ذخیرهسازی محتوا مراجعه کنید.