Apps Komut Dosyası'nı kullanarak Google E-Tablolar'dan Region Lookup API'yi çağırarak bölgeler için çevrimdışı yer kimlikleri arayabilirsiniz. Bu işlem, giriş parametrelerinin belirsiz olduğu ve hata ayıklama gerektirebilecek birden fazla yer kimliğine (ör. "10 Main Street") çözümlenebileceği veri kümeleri için önerilir. Aşağıdaki işlevlere sahip örnek bir komut dosyası sağlandı:
SearchRegionByLocation, sınırı belirtilen enlem/boylam koordinatlarını içeren bir yeri arar.SearchRegionByAddress, sınırı belirtilen adresi içeren bir yeri arar.SearchRegionByPlaceId, belirtilen yer kimliğine sahip bir yeri arar.LookupRegionByName, belirtilen ada sahip bir yeri arar.LookupRegionByUnitCode, belirtilen birim kodunu içeren bir yeri arar.
Bölge Arama özel işlevleri
Özel işlevleri kullanmak için öncelikle Apps Komut Dosyası komut dosyası düzenleyicisine özel .gs komut dosyası kodunu eklemeniz gerekir. Komut dosyası yüklendikten sonra işlevleri, diğer herhangi bir elektronik tablo
fonksiyonunu çağırdığınız gibi çağırabilirsiniz. Komut dosyaları, giriş verilerini hücrelerden alır. E-tablodaki şu şekilde özel işlevleri çağırın:
=LookupRegionByName(A2,C2,D2,E2)
Sonuçlar, işlevi içeren hücrede ve sağdaki iki hücrede çıkarılmıştır. Aday yer kimlikleri varsa bu yer kimliklerine ait sonuçlar da bitişik hücrelerde çıkarılacaktır. Doğrulama için Google Haritalar'da bölge adını ve poligonu gösteren rehber sayfasına bir bağlantı sağlanır. Aşağıdaki örnekte, işlev A1 hücresine yapıştırıldığında sonuçlar şuna benzer olacaktır:
| Yer Kimliği | Yer Sayfası URL'si | Hata kodu |
|---|---|---|
| ChIJLQQwv4qBb0gRIMaY1COLDQU | https://www.google.com/maps/search/?api=1&query=%20&query_place_id=ChIJLQQwv4qBb0gRIMaY1COLDQU |
Yukarıdaki örnekte istek başarılı olduğundan hata hücresi boş görünmektedir. Komut dosyasının düzgün çalışmasını engelleyen hatalar (geçerli bir API anahtarının atlanması gibi) söz konusu olduğunda hata, işlevi içeren hücre için açıklama olarak görünür.
Apps Komut Dosyası'na özel işlevler ekleme
- Google E-Tablolar'da bir e-tablo açın.
- Uzantılar > Apps Komut Dosyası menü öğesini seçin.
- Komut dosyası düzenleyicideki tüm kodları silin.
- Aşağıdaki örnekte verilen kodu kopyalayıp komut dosyası düzenleyiciye yapıştırın.
YOUR_API_KEYöğesini, bölge arama API'sinin etkin olduğu bir projeye ait kısıtlanmamış bir API anahtarıyla değiştirin.- Üst tarafta Kaydet'i tıklayın.
/**
* @fileoverview Provides custom Geo functions in Google Sheets for matching boundaries.
* * SearchRegionByLocation searches for a region whose boundary contains the specified latitude/longitude coordinates.
* * SearchRegionByAddress searches for a region whose boundary contains the specified address.
* * SearchRegionByPlaceId searches for a region whose boundary contains the specified place ID.
* * LookupRegionByName looks up a region with the specified name.
* * LookupRegionByUnitCode looks up a region with the specified unit code.
* @OnlyCurrentDoc
*/
var api_key = "YOUR_API_KEY"; // An unrestricted key is recommended for local use only (deployment is NOT recommended).
function format_url(place_id) {
return place_id && 'https://www.google.com/maps/search/?api=1&query=%20&query_place_id=' + place_id;
}
function format_result(result) {
let matches = result.matches || [];
let firstMatch = result.matches[0] || {};
let placeId = firstMatch.matchedPlaceId || '';
let debugInfo = firstMatch.debugInfo || '';
let candidates = firstMatch.candidatePlaceIds || [];
return [[
placeId || '(NULL)',
format_url(placeId),
debugInfo,
candidates[0],
format_url(candidates[0]),
candidates[1],
format_url(candidates[1]),
candidates[2],
format_url(candidates[2])
]];
}
/**
* Searches for a place whose boundary contains the specified latitude/longitude coordinates.
*
* @param {number} latitude - The latitude where the place will be found (e.g., 37.531939).
* @param {number} longitude - The longitude where the place will be found (e.g., -122.2994121).
* @param {string} place_type - The place type of the place ("postal_code", "administrative_area_level_1", "administrative_area_level_2", "locality", or "country").
*
* @return {string} The place_id of the place, or null if none was found.
*
* @customfunction
*/
function SearchRegionByLocation(
latitude, longitude, place_type) {
var data = {
"search_values": [ {
"latlng": { 'latitude': latitude, 'longitude': longitude }, // { latitude: 37.531939, longitude: -122.2994121 }
"place_type": place_type,
"region_code": null,
"language_code": null,
} ]
};
var options = {
'method' : 'post',
'contentType': 'application/json',
'headers': {
'X-Goog-Api-Key' : api_key
},
// Convert the JavaScript object to a JSON string.
'payload' : JSON.stringify(data)
};
var response = UrlFetchApp.fetch(
'https://regionlookup.googleapis.com/v1alpha:searchRegion',
options);
var resultText = response.getContentText();
console.log(resultText);
var result = JSON.parse(resultText);
return format_result(result);
}
/**
* Searches for a place whose boundary contains the specified address.
*
* @param {string} address - An address within the place boundaries (e.g., "1505 Salado Dr, Mountain View, CA").
* @param {string} place_type - The geo type id of the place (e.g., "locality").
* @param {string} [region_code='us'] - The region code of the place (e.g., "US").
* @param {string} [language_code='en'] - The language code of the place's name. (e.g., "en").
*
* @return {string} The place_id of the place, or null if none was found.
*
* @customfunction
*/
function SearchRegionByAddress(
address, place_type, region_code, language_code) {
var data = {
"search_values": {
"address": address,
"place_type" : place_type,
"region_code": region_code || 'us',
"language_code": language_code || 'en',
}
};
var options = {
'method' : 'post',
'contentType': 'application/json',
'headers': {
'X-Goog-Api-Key' : api_key
},
// Convert the JavaScript object to a JSON string.
'payload' : JSON.stringify(data)
};
var response = UrlFetchApp.fetch(
'https://regionlookup.googleapis.com/v1alpha:searchRegion',
options);
var resultText = response.getContentText();
console.log(resultText);
var result = JSON.parse(resultText);
return format_result(result);
}
/**
* Searches for a place with the specified place ID.
*
* @param {string} place_id - The place ID to search for.
* @param {string} place_type - The geo type id of the place (e.g., "locality").
* @param {string} [region_code='us'] - The region code of the place (e.g., "US").
* @param {string} [language_code='en'] - The language code of the place's name. (e.g., "en").
*
* @return {string} The place_id of the place, or null if none was found.
*
* @customfunction
*/
function SearchRegionByPlaceId(
place_id, place_type, region_code, language_code) {
var data = {
"search_values": {
"place_id": place_id,
"place_type" : place_type,
"region_code": region_code || 'us',
"language_code": language_code || 'en',
}
};
var options = {
'method' : 'post',
'contentType': 'application/json',
'headers': {
'X-Goog-Api-Key' : api_key
},
// Convert the JavaScript object to a JSON string.
'payload' : JSON.stringify(data)
};
var response = UrlFetchApp.fetch(
'https://regionlookup.googleapis.com/v1alpha:searchRegion',
options);
var resultText = response.getContentText();
console.log(resultText);
var result = JSON.parse(resultText);
return format_result(result);
}
/**
* Looks up a place with the specified name.
*
* @param {string} place_name - The name of the place (e.g., "Palo Alto").
* @param {string} place_type - The geo type id of the place (e.g., "locality").
* @param {string} [region_code='us'] - The region code of the place (e.g., "US").
* @param {string} [language_code='en'] - The language code of the place's name. (e.g., "en").
*
* @return {string} The place_id of the place, or null if none was found.
*
* @customfunction
*/
function LookupRegionByName(
place, place_type, region_code, language_code) {
var data = {
"identifiers": [ {
"place": '' + place,
"place_type": place_type,
"region_code": region_code || 'us',
"language_code": language_code || 'en',
}
]
};
var options = {
'method' : 'post',
'contentType': 'application/json',
'headers': {
'X-Goog-Api-Key' : api_key
},
// Convert the JavaScript object to a JSON string.
'payload' : JSON.stringify(data),
//'muteHttpExceptions' : true,
};
var response = UrlFetchApp.fetch(
'https://regionlookup.googleapis.com/v1alpha:lookupRegion',
options);
var resultText = response.getContentText();
console.log(resultText);
var result = JSON.parse(resultText);
return format_result(result);
}
/**
* Looks up a place with the specified unit code.
*
* @param {string} place_name - The name of the place (e.g., "Palo Alto").
* @param {string} place_type - The geo type id of the place (e.g., "locality").
* @param {string} [region_code='us'] - The region code of the place (e.g., "US").
* @param {string} [language_code='en'] - The language code of the place's name. (e.g., "en").
*
* @return {string} The place_id of the place, or null if none was found.
*
* @customfunction
*/
function LookupRegionByUnitCode(
unit_code, place_type, region_code, language_code) {
var data = {
"identifiers": [ {
"unit_code": '' + unit_code,
"place_type": place_type,
"region_code": region_code || 'us',
"language_code": language_code || 'en',
}
]
};
var options = {
'method' : 'post',
'contentType': 'application/json',
'headers': {
'X-Goog-Api-Key' : api_key
},
// Convert the JavaScript object to a JSON string.
'payload' : JSON.stringify(data),
//'muteHttpExceptions' : true,
};
var response = UrlFetchApp.fetch(
'https://regionlookup.googleapis.com/v1alpha:lookupRegion',
options);
var resultText = response.getContentText();
console.log(resultText);
var result = JSON.parse(resultText);
return format_result(result);
}