API ژئوکدینگ نسخه ۴ سرویسی است که ژئوکدینگ، ژئوکدینگ معکوس آدرسها و شناسههای مکان و اطلاعات مقصد را ارائه میدهد.
ژئوکدینگ فرآیند تبدیل آدرسها (مانند آدرس خیابان) به مختصات جغرافیایی (مانند طول و عرض جغرافیایی) است که میتوانید از آن برای قرار دادن نشانگرها روی نقشه یا تعیین موقعیت نقشه استفاده کنید.
ژئوکدینگ معکوس فرآیند تبدیل مختصات جغرافیایی به آدرسی قابل خواندن برای انسان است.
همچنین میتوانید از API مربوط به Geocoding برای یافتن آدرس یک شناسه مکان مشخص استفاده کنید.
نمونه درخواست و پاسخ
شما از طریق رابط HTTP به API مربوط به Geocoding دسترسی پیدا میکنید. در ادامه نمونههایی از درخواستهای geocoding و reverse geocoding آمده است.
درخواست و پاسخ ژئوکدینگ (جستجوی طول و عرض جغرافیایی)
مثال زیر طول و عرض جغرافیایی "1600 Amphitheatre Parkway, Mountain View, CA" را درخواست میکند و مشخص میکند که خروجی باید در قالب JSON باشد.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
میتوانید این را با وارد کردن URL در مرورگر وب خود آزمایش کنید (حتماً YOUR_API_KEY با کلید API واقعی خود جایگزین کنید). پاسخ شامل طول و عرض جغرافیایی آدرس است.
برای اطلاعات بیشتر در مورد ساخت URL های درخواست geocoding ، پارامترهای موجود و درک پاسخ ، به راهنمای توسعه دهنده مراجعه کنید.
در زیر یک نمونه پاسخ ژئوکدینگ، در قالب JSON، آمده است:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
درخواست و پاسخ معکوس ژئوکدینگ (جستجوی آدرس)
مثال زیر آدرس مربوط به طول/عرض جغرافیایی داده شده در بروکلین، نیویورک، ایالات متحده را درخواست میکند. این مثال مشخص میکند که خروجی باید در قالب JSON باشد.
https://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYمیتوانید این را با وارد کردن URL در مرورگر وب خود آزمایش کنید (مطمئن شوید که 'YOUR_API_KEY' را با کلید API واقعی خود جایگزین میکنید). پاسخ شامل یک آدرس قابل خواندن توسط انسان برای موقعیت مکانی با طول و عرض جغرافیایی است.
برای اطلاعات بیشتر در مورد ساخت URL های درخواست geocoding معکوس ، پارامترهای موجود و درک پاسخ ، به راهنمای توسعه دهنده مراجعه کنید.
در زیر یک نمونه پاسخ ژئوکدینگ معکوس، در قالب JSON، آمده است:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
احراز هویت، سهمیهها، قیمتگذاری و سیاستها
احراز هویت
برای استفاده از API مربوط به Geocoding، ابتدا باید API را فعال کرده و اعتبارنامههای احراز هویت مناسب را دریافت کنید. برای اطلاعات بیشتر، به «شروع به کار با پلتفرم نقشههای گوگل» مراجعه کنید.
سهمیهها و قیمتگذاری
برای جزئیات بیشتر در مورد سهمیهها و قیمتهای تعیینشده برای API ژئوکدینگ، صفحه استفاده و صورتحساب را بررسی کنید.
سیاستها
استفاده از API مربوط به Geocoding باید مطابق با سیاستهای API باشد.