Geolocation API سرویسی است که درخواست HTTPS را با برج سلولی و نقاط دسترسی WiFi که یک کلاینت تلفن همراه میتواند شناسایی کند، میپذیرد. مختصات طول و عرض جغرافیایی و شعاع نشان دهنده دقت نتیجه برای هر ورودی معتبر را برمی گرداند.
چرا از API جغرافیایی استفاده کنیم؟
از Geolocation API برای مکان یابی دستگاه های تلفن همراهی که ویژگی های موقعیت جغرافیایی بومی را ارائه نمی دهند، استفاده کنید.
کارهایی که می توانید با API جغرافیایی انجام دهید
با استفاده از Geolocation API، میتوانید از دادههای مکانی از برجهای سلولی و گرههای WiFi برای دریافت موقعیت مکانی دستگاهی که موقعیت جغرافیایی بومی یا GPS ندارد استفاده کنید.
نحوه عملکرد API مکان جغرافیایی
Geolocation API از فیلدهای داده دستگاه سلولی، دادههای برج سلولی و دادههای آرایه نقطه دسترسی WiFi برای برگرداندن مختصات طول و عرض جغرافیایی و شعاع دقت استفاده میکند. یک درخواست HTTPS POST را به همراه یک بدنه درخواست ساختار یافته JSON به نقطه پایانی خود می پذیرد. مثال زیر نشانی وب درخواست و یک نمونه بدنه درخواست را نشان می دهد:
curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY " \ -H "Content-Type: application/json" \ -d \ '{ "homeMobileCountryCode":310, "homeMobileNetworkCode":410, "radioType":"gsm", "carrier":"Vodafone", "considerIp":true }'
منابع
جدول زیر فیلدهای بدنه درخواست تماس نقطه پایانی مکان جغرافیایی را به همراه نوع دادههای ارائه شده از چنین جستارهایی خلاصه میکند.
منابع داده | داده ها برگردانده شد | فرمت بازگشت |
---|---|---|
فیلدهای داده دستگاه سلولی مانند اطلاعات حامل، دستگاه و شبکه. | مختصات طول و عرض جغرافیایی و شعاع دقت | JSON |
دادههای برج سلولی ، مانند کد منطقه مکان و کدهای کشور تلفن همراه. | ||
دادههای نقاط دسترسی WiFi ، مانند آدرس MAC و قدرت سیگنال. |
نحوه استفاده از Geolocation API
1 | راه اندازی شود | با راهاندازی پروژه Google Cloud خود شروع کنید و دستورالعملهای راهاندازی را تکمیل کنید. |
2 | درخواست موقعیت جغرافیایی را امتحان کنید | هنگامی که یک کلید API دارید، می توانید با استفاده از cURL یا Postman شروع به آزمایش API مکان جغرافیایی کنید. برای جزئیات بیشتر به درخواستهای نمونه در راهنمای درخواستهای موقعیت جغرافیایی و پاسخ مراجعه کنید. |
3 | شناسه سلولی را از برج های رادیویی مختلف دریافت کنید | برای دسترسی به برج های قدیمی و جدیدتر به ترتیب به محاسبه cellID و محاسبه newRadioCellID مراجعه کنید. |
4 | اصول پاسخگویی را درک کنید | برای آماده شدن برای استفاده از داده های ارتفاع برای برنامه خود، پاسخ های داده های موقعیت جغرافیایی را کاوش کنید. برای جزئیات بیشتر به پاسخ های موقعیت جغرافیایی مراجعه کنید. |
کتابخانه های مشتری موجود
این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:
- Java Client برای خدمات Google Maps
- کلاینت پایتون برای خدمات نقشه های گوگل
- Go Client برای خدمات Google Maps
- Node.js Client برای خدمات Google Maps
Java Client، Python Client، Go Client و Node.js Client برای سرویسهای Google Maps، کتابخانههای مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.
بعدش چی
- با نمونه درخواست ها و پاسخ ها شروع کنید : به درخواست و پاسخ موقعیت جغرافیایی بروید
- بهترین شیوه ها را دنبال کنید : به بهترین روش های خدمات وب بروید.
- درک صورتحساب : به استفاده و صورتحساب بروید.