امکان تبدیل بین یک آدرس و مختصات جغرافیایی را فراهم می کند.
مثال زیر نشان میدهد که چگونه میتوانید از این کلاس استفاده کنید تا 9 مورد برتر را برای مکان "Main St" در کلرادو پیدا کنید، آنها را به نقشه اضافه کنید و سپس آن را در Google Doc جدید جاسازی کنید.
// Find the best matches for "Main St" in Colorado. var response = Maps.newGeocoder() // The latitudes and longitudes of southwest and northeast corners of Colorado, respectively. .setBounds(36.998166, -109.045486, 41.001666,-102.052002) .geocode('Main St'); // Create a Google Doc and map. var doc = DocumentApp.create('My Map'); var map = Maps.newStaticMap(); // Add each result to the map and doc. for (var i = 0; i < response.results.length && i < 9; i++) { var result = response.results[i]; map.setMarkerStyle(null, null, i + 1); map.addMarker(result.geometry.location.lat, result.geometry.location.lng); doc.appendListItem(result.formatted_address); } // Add the finished map to the doc. doc.appendImage(Utilities.newBlob(map.getMapImage(), 'image/png'));
همچنین ببینید
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
geocode(address) | Object | نقاط جغرافیایی تقریبی یک آدرس را دریافت می کند. |
reverseGeocode(latitude, longitude) | Object | آدرس های تقریبی یک نقطه جغرافیایی معین را دریافت می کند. |
setBounds(swLatitude, swLongitude, neLatitude, neLongitude) | Geocoder | محدوده ناحیه ای را که باید در نتایج اولویت بیشتری داشته باشد را تعیین می کند. |
setLanguage(language) | Geocoder | زبان مورد استفاده در نتایج را تنظیم می کند. |
setRegion(region) | Geocoder | منطقه ای را برای استفاده در هنگام تفسیر نام مکان ها تنظیم می کند. |
مستندات دقیق
geocode(address)
نقاط جغرافیایی تقریبی یک آدرس را دریافت می کند.
// Gets the geographic coordinates for Times Square. var response = Maps.newGeocoder().geocode('Times Square, New York, NY'); for (var i = 0; i < response.results.length; i++) { var result = response.results[i]; Logger.log('%s: %s, %s', result.formatted_address, result.geometry.location.lat, result.geometry.location.lng); }
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
address | String | یک آدرس |
برگشت
Object
- یک شی JSON حاوی داده های رمزگذاری جغرافیایی، همانطور که در اینجا توضیح داده شده است
reverseGeocode(latitude, longitude)
آدرس های تقریبی یک نقطه جغرافیایی معین را دریافت می کند.
// Gets the address of a point in Times Square. var response = Maps.newGeocoder().reverseGeocode(40.758577, -73.984464); for (var i = 0; i < response.results.length; i++) { var result = response.results[i]; Logger.log('%s: %s, %s', result.formatted_address, result.geometry.location.lat, result.geometry.location.lng); }
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
latitude | Number | عرض جغرافیایی نقطه |
longitude | Number | طول جغرافیایی نقطه |
برگشت
Object
- یک شی JSON حاوی داده های معکوس جغرافیایی، همانطور که در اینجا توضیح داده شده است
همچنین ببینید
setBounds(swLatitude, swLongitude, neLatitude, neLongitude)
محدوده ناحیه ای را که باید در نتایج اولویت بیشتری داشته باشد را تعیین می کند.
// Creates a Geocoder that prefers points in the area of Manhattan. var geocoder = Maps.newGeocoder() .setBounds(40.699642, -74.021072, 40.877569, -73.908548);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
swLatitude | Number | عرض جغرافیایی گوشه جنوب غربی محدوده |
swLongitude | Number | طول جغرافیایی گوشه جنوب غربی محدوده |
neLatitude | Number | عرض جغرافیایی گوشه شمال شرقی محدوده |
neLongitude | Number | طول جغرافیایی گوشه شمال شرقی محدوده |
برگشت
Geocoder
- شی Geocoder برای تسهیل زنجیره ای شدن تماس ها
همچنین ببینید
setLanguage(language)
زبان مورد استفاده در نتایج را تنظیم می کند.
// Creates a Geocoder with the language set to French. var geocoder = Maps.newGeocoder().setLanguage('fr');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
language | String | یک شناسه زبان BCP-47 |
برگشت
Geocoder
- شی Geocoder برای تسهیل زنجیره ای شدن تماس ها.
همچنین ببینید
setRegion(region)
منطقه ای را برای استفاده در هنگام تفسیر نام مکان ها تنظیم می کند. کدهای منطقه پشتیبانی شده با ccTLD های پشتیبانی شده توسط Google Maps مطابقت دارد. برای مثال، کد منطقه "uk" با "maps.google.co.uk" مطابقت دارد.
// Creates a Geocoder with the region set to France. var geocoder = Maps.newGeocoder().setRegion('fr');
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
region | String | کد منطقه برای استفاده |
برگشت
Geocoder
- شی Geocoder برای تسهیل زنجیره ای شدن تماس ها