İstek
Geocoding API isteği aşağıdaki biçimdedir:
https://maps.googleapis.com/maps/api/geocode/outputFormat?parameters
Bu örnekte outputFormat
, aşağıdaki değerlerden biri olabilir:
json
(önerilen), JavaScript Nesne Gösterimi (JSON) biçiminde çıkışı gösterir veyaxml
, XML'deki çıkışı belirtir
HTTPS gerekli.
Bazı parametreler zorunlu, bazıları ise isteğe bağlıdır. URL'lerde standart olduğu gibi,
parametreleri "ve" (&
) karakteri kullanılarak ayrılır.
Bu sayfanın geri kalanında, coğrafi kodlama ve coğrafi kodlamayı ayrı olarak tersine çevirme Her istek türü için farklı parametreler kullanılabilir.
Coğrafi kodlama (enlem/boylam arama) parametreleri
Coğrafi kodlama isteğindeki gerekli parametreler:
address
— Açık adres veya artı kodu URL'sini girin. Biçime uygun olarak adresleri belirtin ilgili ülkenin ulusal posta servisi tarafından kullanılması. İşletme adları ve daire, apartman veya kat numaraları gibi ek adres öğelerinden kaçınılmalıdır. Cadde adresi öğeleri boşluklarla ayrılmalıdır (burada%20
olarak URL'ye kaçan olarak gösterilmiştir):address=24%20Sussex%20Drive%20Ottawa%20ON
Artı kodlarını burada gösterildiği gibi biçimlendirin (artı işaretleri%2B
olarak URL'ye kaçan, boşluklar ise%20
olarak URL'ye kaçan olarak gösterilmiştir):- global kod, 4 karakterlik bir alan kodudur ve en az 6 karakterden oluşur
yerel kod (849VCWC8+R9,
849VCWC8%2BR9
şeklindedir). - Karma kod, açık bir konuma sahip 6 karakter veya daha uzun bir yerel koddur (CWC8+R9 Mountain View, CA, ABD için
CWC8%2BR9%20Mountain%20View%20CA%20USA
).
--VEYA--
components
: Bir boru (|
) ile ayrılmış öğeleri içeren bileşen filtresi.address
sağlanırsa bileşen filtresi isteğe bağlı parametre olarak da kabul edilir. Bileşenler filtresindeki her öğe bircomponent:value
eşlenir ve sonuçları tamamen kısıtlar alır. Daha fazla bilgi için: bileşen filtreleme bölümüne bakın.- global kod, 4 karakterlik bir alan kodudur ve en az 6 karakterden oluşur
yerel kod (849VCWC8+R9,
key
— Uygulamanızın API anahtarı. Bu anahtar, bunu yapmanızı öneririz. Nasıl yapıldığını öğrenin bir anahtar al.
Lütfen SSS sayfasına göz atın göz atmayı unutmayın.
Coğrafi kodlama isteğinde isteğe bağlı parametreler:
bounds
: Coğrafi kodlama sonuçlarını daha belirgin hale getirmek için içinden yararlanılacak görüntü alanının sınır kutusu. Bu parametre, coğrafi kodlayıcıdan gelen sonuçları yalnızca etkiler, tamamen kısıtlamaz. (Daha fazla bilgi için aşağıdaki Görüntüleme Alanı Eğilimi bölümüne bakın.)language
: Sonuçların döndürüleceği dil.- Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediğinden bu liste tam olmayabilir.
language
sağlanmazsa coğrafi kodlayıcı bölümünde belirtildiği şekilde tercih edilen dili kullanın.Accept-Language
üstbilgisi veya isteğin gönderildiği alan adı.- Coğrafi kodlayıcı, hem kullanıcı hem de yerel halk tarafından okunabilen bir açık adres sağlamak için elinden geleni yapar. Bu amaca ulaşmak için, tercih edilen dile göre sokak adreslerini yerel dilde, gerekirse kullanıcı tarafından okunabilen bir yazım sistemine dönüştürülmüş şekilde döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen aynı dilde döndürülür.
- Tercih edilen dilde bir ad mevcut değilse coğrafi kodlayıcı, en yakın eşleşmedir.
- Tercih edilen dilin, arama sonuçlarında görünen döndürmeyi seçtiği sıra ve bunların döndürülme sırasına göre belirlenir. Coğrafi kodlayıcı, kısaltmaları dile göre farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar. Örneğin, Macarcada utca ve tér sırasıyla sokak ve meydanın eş anlamlısıdır.
region
: ccTLD ("üst düzey alan") iki karakterli değer olarak belirtilen bölge kodu. Bu parametre yalnızca coğrafi kodlayıcıdan gelen sonuçlar üzerindeki etkisinin tam olarak kısıtlanmamasını sağlar. (Daha fazla bilgi için aşağıdaki Bölge Eğilimi bölümüne bakın.) Bu parametre, geçerli yasaya göre sonuçları da etkileyebilir.components
— Öğe içeren bir bileşen filtresi dikey çizgiyle (|
) ayrılmalıdır. Bileşen filtresi İstek biraddress
içermiyorsa zorunludur. Bileşenler filtresindeki her öğe bircomponent:value
çiftinden oluşur ve coğrafi kodlayıcıdan gelen sonuçları tamamen kısıtlar. Bileşen filtreleme hakkında daha fazla bilgiyi aşağıda bulabilirsiniz.extra_computations
: Yanıtta aşağıdaki ek özellikleri belirtmek için bu parametreyi kullanın:ADDRESS_DESCRIPTORS
: Daha fazla bilgi için adres tanımlayıcılarına göz atın.BUILDING_AND_ENTRANCES
— Bkz. girişlere ve bina ana hatlarına bakın.
extra_computations
parametresini ekleyin. Örneğin:extra_computations=ADDRESS_DESCRIPTORS&extra_computations=BUILDING_AND_ENTRANCES
Yanıtlar
Coğrafi kodlama yanıtları, URL isteğinde output
işaretiyle belirtilen biçimde veya varsayılan olarak JSON biçiminde döndürülür.
Bu örnekte, Coğrafi Kodlama API'si bir json
isteğinde bulunuyor.
"1600 Amphitheatre Parkway, Mountain View,
Kanada".
Bu istek, JSON output
işaretinin kullanılmasını göstermektedir:
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Bu istek, XML output
işaretinin nasıl kullanıldığını gösterir:
https://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Örnek JSON ve XML yanıtlarını görmek için aşağıdaki sekmeleri seçin.
JSON
{ "results": [ { "address_components": [ { "long_name": "1600", "short_name": "1600", "types": [ "street_number" ] }, { "long_name": "Amphitheatre Parkway", "short_name": "Amphitheatre Pkwy", "types": [ "route" ] }, { "long_name": "Mountain View", "short_name": "Mountain View", "types": [ "locality", "political" ] }, { "long_name": "Santa Clara County", "short_name": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ] }, { "long_name": "California", "short_name": "CA", "types": [ "administrative_area_level_1", "political" ] }, { "long_name": "United States", "short_name": "US", "types": [ "country", "political" ] }, { "long_name": "94043", "short_name": "94043", "types": [ "postal_code" ] }, { "long_name": "1351", "short_name": "1351", "types": [ "postal_code_suffix" ] } ], "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry": { "location": { "lat": 37.4222804, "lng": -122.0843428 }, "location_type": "ROOFTOP", "viewport": { "northeast": { "lat": 37.4237349802915, "lng": -122.083183169709 }, "southwest": { "lat": 37.4210370197085, "lng": -122.085881130292 } } }, "place_id": "ChIJRxcAvRO7j4AR6hm6tys8yA8", "plus_code": { "compound_code": "CWC8+W7 Mountain View, CA", "global_code": "849VCWC8+W7" }, "types": [ "street_address" ] } ], "status": "OK" }
JSON yanıtının iki kök öğe içerdiğini unutmayın:
"status"
, istekle ilgili meta verileri içerir. Görüntüleyin Durum kodları aşağıdadır."results"
, coğrafi olarak kodlanmış adres bilgileri dizisi ve veya geometrik şekil bilgisidir.
Adres aramaları için genellikle "results"
dizisinde yalnızca bir giriş döndürülür ancak adres sorguları belirsiz olduğunda coğrafi kodlayıcı birkaç sonuç döndürebilir.
XML
<GeocodeResponse> <status>OK</status> <result> <type>street_address</type> <formatted_address>1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA</formatted_address> <address_component> <long_name>1600</long_name> <short_name>1600</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Amphitheatre Parkway</long_name> <short_name>Amphitheatre Pkwy</short_name> <type>route</type> </address_component> <address_component> <long_name>Mountain View</long_name> <short_name>Mountain View</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>Santa Clara County</long_name> <short_name>Santa Clara County</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>California</long_name> <short_name>CA</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>United States</long_name> <short_name>US</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>94043</long_name> <short_name>94043</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>37.4224428</lat> <lng>-122.0842467</lng> </location> <location_type>ROOFTOP</location_type> <viewport> <southwest> <lat>37.4212648</lat> <lng>-122.0856069</lng> </southwest> <northeast> <lat>37.4239628</lat> <lng>-122.0829089</lng> </northeast> </viewport> </geometry> <place_id>ChIJeRpOeF67j4AR9ydy_PIzPuM</place_id> <plus_code> <global_code>849VCWC8+X8</global_code> <compound_code>CWC8+X8 Mountain View, CA</compound_code> </plus_code> </result> </GeocodeResponse>
XML yanıtının tek bir <GeocodeResponse>
ve iki üst düzey öğeden oluştuğunu unutmayın:
<status>
, istekte meta verileri içeriyor. Görüntüleyin Durum kodları aşağıdadır.- Sıfır veya daha fazla
<result>
öğesi, her biri tek bir öğe içeriyor coğrafi olarak kodlanmış adres bilgileri ve geometri bilgileri kümesidir.
XML yanıtı, JSON yanıtından çok daha uzundur. Örneğin,
Bu nedenle, tercih edilen veri kaynağı olarak json
hizmetiniz herhangi bir nedenle xml
gerektirmiyorsa çıkış işareti ekleyin.
Ayrıca, XML ağaçlarını işlemek için de referans
doğru şekilde hazırlamanız gerekir. Çıkış işleme için önerilen bazı tasarım kalıpları için
XPath ile XML'i ayrıştırma başlıklı makaleyi inceleyin.
- XML sonuçları bir kök
<GeocodeResponse>
öğesinde sarmalanır. - JSON, birden fazla öğe içeren girişleri çoğul dizilerle (
types
) gösterirken XML bunları birden fazla tekil öğeyle (<type>
) gösterir. - Boş öğeler JSON'da boş dizilerle, XML'de ise bu tür bir öğenin yokluğuyla belirtilir. Sonuç döndürmeyen bir yanıt, JSON'da boş bir
results
dizisi döndürür ancak örneğin XML'de<result>
öğesi döndürmez.
Durum kodları
Coğrafi Kodlama yanıt nesnesindeki "status"
alanı,
ve coğrafi kodlamanın neden bu şekilde olduğunu anlamanıza yardımcı olacak hata ayıklama bilgileri
çalışmıyor. "status"
alanı aşağıdaki değerleri içerebilir:
"OK"
, herhangi bir hata oluşmadığını belirtir; adres başarıyla ayrıştırıldı ve en az bir coğrafi kod döndürüldü."ZERO_RESULTS"
, coğrafi kodlamanın başarılı olduğunu ancak hiçbir sonuç döndürmediğini gösterir. Bu durum, coğrafi kodlayıcıya var olmayan biraddress
kodundan geçilmesi durumunda ortaya çıkabilir.OVER_DAILY_LIMIT
aşağıdakilerden herhangi birini gösterir:- API anahtarı eksik veya geçersiz.
- Hesabınızda faturalandırma etkinleştirilmedi.
- Kendi kendine belirlenen kullanım sınırı aşıldı.
- Belirtilen ödeme yöntemi artık geçerli değil (örneğin, Kredi kartının geçerlilik süresi sona ermiş).
Bilgi edinmek için Haritalar hakkında SSS sayfasına bakın. Nasıl düzeltilir?
"OVER_QUERY_LIMIT"
, kotanızı aştığınızı gösterir."REQUEST_DENIED"
, isteğinizin reddedildiğini gösterir."INVALID_REQUEST"
genellikle sorgunun (address
,components
veyalatlng
) eksik olduğunu gösterir."UNKNOWN_ERROR"
, isteğinin sunucu hatası nedeniyle işlenemediğini gösterir. Tekrar denerseniz istek başarılı olabilir.
Hata mesajları
Coğrafi kodlayıcı, OK
dışında bir durum kodu döndürdüğünde,
error_message
alanını göreceksiniz. Bu alanda daha fazla yer var
nedenleriyle ilgili ayrıntılı bilgi edinebilirsiniz.
Sonuçlar
Coğrafi kodlayıcı, sonuçları (JSON) results
dizisine yerleştirir. Coğrafi kodlayıcı hiçbir sonuç döndürmese bile (adres mevcut değilse örneğin)
boş bir results
dizisi döndürür. (XML yanıtları sıfır veya daha fazla <result>
öğesinden oluşur.)
Tipik bir sonuç aşağıdaki alanları içerir:
types[]
dizisi, döndürülen sonucun türünü belirtir. Bu dizi, özelliğini gönderin. Örneğin, "Chicago"nun coğrafi kodu iadelerin toplam tutarı "yerellik" Bu da "Chicago"nun bir şehir ve aynı zamanda "siyasi" değerini döndürür Bu simge, siyasi bir tüzel kişilik olduğunu gösteriyor. İlgili adres bileşeni için bilinen tür olmadığında bileşenlerin tür dizisi boş olabilir. API, gerektiğinde yeni tür değerleri ekleyebilir. Daha fazla bilgi için Adres türleri ve adres bileşenleri başlıklı makaleye bakın.formatted_address
, okunabilir öğeleri içeren bir dizedir bu konumun adresine sahip olur.Bu adres genellikle posta adresiyle aynıdır. Bazı Birleşik Krallık gibi ülkelerde, doğru lisans kısıtlamaları nedeniyle posta adresi.
Biçimlendirilmiş adres mantıksal olarak bir veya daha fazla adres bileşeninden oluşur. Örneğin, "111 8. Cadde, New York, NY" adresi şu bileşenlerden oluşur: "111" (bina numarası), "8. Cadde" (rota), "New York" (şehir) ve "NY" (ABD eyaleti).
Biçimlendirilmiş adresi programlı olarak ayrıştırmayın. Bunun yerine, biçimlendirilmiş adres alanına ek olarak API yanıtının içerdiği bağımsız adres bileşenlerini kullanmanız gerekir.
address_components[]
, bu adres için geçerli olan bileşenleri içerir.Her adres bileşeni genellikle aşağıdaki alanları içerir:
types[]
, adres bileşeninin türünü belirten bir dizidir. Şu listeye bakın: desteklenen türlere tabidir.long_name
, Coğrafi Kodlayıcı tarafından döndürülen adres bileşeninin tam metin açıklaması veya adıdır.short_name
, adres için kısaltılmış bir metin adıdır bileşenini (varsa) kontrol edin. Örneğin, eyalet için bir adres bileşeni için sahip olduğulong_name
oranında "Alaska" veshort_name
/"AK" kullanın.
address_components[]
dizisiyle ilgili aşağıdaki noktalara dikkat edin:- Adres bileşenleri dizisi,
formatted_address
- Dizi,
formatted_address
'ye dahil olanlar dışında, adres içeren tüm siyasi varlıkları içermeyebilir. Tüm siyasi varlıkları geri almak için veya belirli bir adres içerenler varsa ters coğrafi kodlamayı, isteğin bir parametresi olarak adresin enlem/boylamı. - Yanıt biçiminin
kabul edersiniz. Özellikle,
address_components
sayısı talep edilen adrese göre değişir ve zaman içinde aynı adrese sahip olmalıdır. Bir bileşen, dizideki konumunu değiştirebilir. Bileşenin türü değişebilir. Belirli bir bileşen, daha sonraki bir yanıtta eksik olabilir.
Bileşen dizisini işlemek için yanıtı ayrıştırmanız gerekir ve ifadeler aracılığıyla uygun değerleri seçebilirsiniz. Bu kılavuza göz atın: daha fazla bilgi edinebilirsiniz.
postcode_localities[]
, en fazla 100 yerleşimi belirten bir dizidir bir posta kodunda yer alır. Bu, yalnızca sonuç birden fazla yerleşim yeri içeren bir posta kodu olduğunda gösterilir.geometry
aşağıdaki bilgileri içerir:location
, coğrafi olarak kodlanmış enlem ve boylam değerini içeriyor. Normal bu alan genellikle en önemli olanıdır.location_type
, belirtilen konumla ilgili ek verileri depolar. Şu anda aşağıdaki değerler desteklenmektedir:"ROOFTOP"
, döndürülen sonucun açık adres kesinliğine kadar doğru konum bilgilerine sahip olmamızı sağlar."RANGE_INTERPOLATED"
şunu belirtir: döndüren sonucun bir projeyi iki kesin nokta (kavşaklar gibi) arasında interpolasyon yapılan yaklaşım (genellikle bir yolda). Doğrusal olmayan sonuçlar genellikle bir sokak adresi için çatı jeokodları kullanılamadığında döndürülür."GEOMETRIC_CENTER"
, döndürülen sonucun bir poli çizgi (ör. sokak) veya poligon (bölge) gibi bir sonucun geometrik merkezi olduğunu gösterir."APPROXIMATE"
, döndürülen sonucun yaklaşık olduğunu gösterir.
viewport
, görüntülenmesi için önerilen görüntü alanını içeriyor tanımlayan iki enlem, boylam değeri olarak belirtilen,döndürülen sonuçsouthwest
ve görüntü alanı sınırlayıcı kutusununnortheast
köşesi. Genellikle bir sonucu kullanıcıya gösterirken çerçevelemek için görüntü alanı kullanılır.bounds
(isteğe bağlı olarak döndürülür) sınırlayıcı kutuyu depolar Bu satır öğesi, döndürülen sonucu tam olarak içerebilir. Bu sınırların önerilen görüntü alanı ile eşleşmeyebileceğini unutmayın. (Örneğin, San Francisco teknik olarak şehrin bir parçası olan ancak görüntü alanında döndürülmemesi muhtemel Farallon adalarını içerir.)
-
plus_code
(bkz. Konum Kodunu Aç ve artı kodları) buradaki enlem ve boylam koordinatlarından türetilen, yüksek performanslı konum referansı bir alanı ifade eder: derecenin 1/8.000'i x 1/8.000'i (yaklaşık 14 m x) ekvatorda 14 m) veya daha kısa olmalıdır. Artı kodları, adreslerin bulunmadığı yerlerde (binaların bulunmadığı yerlerde) veya sokaklar adlandırılmamıştır). API her zaman artı kodu döndürmez.Hizmet bir artı kodu döndürdüğünde bu kod, genel kod ve bileşik kod olarak biçimlendirilir:
global_code
, 4 karakterli bir alan kodu ve 6 karakter veya daha uzun bir yerel koddur (849VCWC8+R9).compound_code
, açık bir konuma sahip 6 karakter veya daha uzun bir yerel koddur (CWC8+R9, Mountain View, CA, ABD). Bu içeriği programatik olarak ayrıştırmayın.
-
partial_match
, coğrafi kodlayıcının istenen adresin bir kısmını eşleştirebilmesine rağmen orijinal istek için tam eşleşme döndürmediğini gösterir. Orijinal isteği yazım hataları ve/veya eksik adres olup olmadığını kontrol etmek isteyebilirsiniz.Kısmi eşleşmeler genellikle, var olmayan açık adresler için ortaya çıkar istekte bulunduğunuz şehir içinde olmalıdır. Bir istek aynı bölgedeki iki veya daha fazla konumla eşleştiğinde de kısmi eşleşmeler döndürülebilir. Örneğin, "Hillpar St, Bristol, Birleşik Krallık" araması hem Henry Street hem de Henrietta Street için kısmi eşleşme döndürür. Bir talepte bir yanlış yazılmış adres bileşeni varsa, coğrafi kodlama hizmeti bunun yerine girin. Bu şekilde tetiklenen öneriler de kısmi eşleşme olarak işaretlenir.
place_id
, diğer Google API'leriyle kullanılabilen benzersiz bir tanımlayıcıdır. Örneğin, yerel bir işletmenin telefon numarası, çalışma saatleri, kullanıcı yorumları gibi ayrıntılarını almak için Places API isteğindeplace_id
parametresini kullanabilirsiniz. Yer kimliğine genel bakış başlıklı makaleyi inceleyin.
Adres türleri ve adres bileşeni türleri
Sonuçtaki types[]
dizisi, adres türünü gösterir. Adres türlerine örnek olarak açık adres, ülke veya siyasi tüzel kişi verilebilir. Şu konumda da bir types[]
dizisi var:
her bölümünün türünü gösteren address_components[]
girin. Bina numarası veya ülke buna örnek gösterilebilir. (Türlerin tam listesini aşağıda bulabilirsiniz.) Adreslerin birden fazla türü olabilir. Türler, "etiketler" olarak kabul edilebilir.
Örneğin, birçok şehir political
ve locality
türüyle etiketlenir.
Coğrafi kodlayıcı, aşağıdaki türleri hem adres türü hem de adres bileşeni türü dizilerinde destekler ve döndürür:
street_address
, tam açık adresi gösterir.route
, adlandırılmış bir rotayı ("US 101" gibi) gösterir.intersection
, genellikle iki ana yolun kesiştiği önemli bir kavşağı gösterir.political
, siyasi bir tüzel kişiyi gösterir. Genellikle bu tür, bir sivil idarenin poligonunu gösterir.country
, ulusal siyasi kuruluşu belirtir ve genellikle Coğrafi Kodlayıcı tarafından döndürülen en yüksek sipariş türüdür.administrative_area_level_1
, birinci dereceden bir hukuki danışmanlığı gösterir ülke düzeyinin altında bir öğe tutarıdır. Amerika Birleşik Devletleri'nde idari düzeyler eyalettir. Tüm ülkeler bu idari düzeyleri göstermez. Çoğu durumda, yönetici_alanı_seviyesi_1 kısa adlar, ISO 3166-2 alt bölümleri ve diğer geniş kapsamlı dağıtım yapılan listeler; Ancak coğrafi kodlama sonuçlarımız çeşitli sinyallere ve konum verilerine dayanır.administrative_area_level_2
, ülke düzeyinin altındaki ikinci düzey sivil bir varlığı gösterir. Amerika Birleşik Devletleri'nde idari düzeyler ilçedir. Tüm ülkeler bu idari düzeyleri göstermez.administrative_area_level_3
, üçüncü düzey bir hukuki danışmanlığı belirtir ülke düzeyinin altında bir öğe tutarıdır. Bu tür, küçük bir sivil toplum bölmesini belirtir. Tüm uluslar bu idari düzeylerde değildir.administrative_area_level_4
, ülke düzeyinin altında dördüncü düzey bir sivil tüzel kişiyi belirtir. Bu tür, küçük bir sivil toplum bölmesini belirtir. Tüm ülkelerde bu idari düzeyler bulunmaz.administrative_area_level_5
, beşinci sıradan bir sivil toplumu gösterir ülke düzeyinin altında bir öğe tutarıdır. Bu tür, küçük bir sivil toplum bölmesini belirtir. Tüm ülkelerde bu idari düzeyler bulunmaz.administrative_area_level_6
, ülke düzeyinin altındaki altıncı düzey sivil bir varlığı belirtir. Bu tür, küçük bir sivil toplum bölmesini belirtir. Tüm ülkelerde bu idari düzeyler bulunmaz.administrative_area_level_7
, yedinci düzey hukuku belirtir ülke düzeyinin altında bir öğe tutarıdır. Bu tür, küçük bir sivil toplum bölmesini belirtir. Tüm uluslar bu idari düzeylerde değildir.colloquial_area
, öğe için yaygın olarak kullanılan alternatif bir adı gösterir.locality
, tüzel kişiliğe sahip bir şehir veya kasaba siyasi tüzel kişisini gösterir.sublocality
, bir yerin altındaki birinci sınıf sivil bir varlığı gösterir. Bazı konumlar için ek türlerden biri sunulabilir:sublocality_level_1
-sublocality_level_5
. Her alt konum düzeyi bir sivil tüzel kişidir. Daha büyük sayılar daha küçük bir coğrafi alanı gösterir.neighborhood
, adlandırılmış bir mahalleyi gösterirpremise
, adlandırılmış bir konumu (genellikle bir bina veya ortak bir ada sahip bina koleksiyonusubpremise
, adlandırılmış bir öğenin altındaki birinci derece öğeyi gösterir. bir dizi binanın içinde yer alan tek bir binadır. Bu yapı, genellikle yaygın bir adplus_code
, türetilmiş kodlanmış konum referansını gösterir enlem ve boylama göre belirlenir. Plus code'lar, açık adreslerin bulunmadığı yerlerde (binaların numaralandırılmadığı veya sokakların adlandırılmadığı yerlerde) açık adreslerin yerine kullanılabilir. https://plus.codes sayfasına bakın inceleyebilirsiniz.postal_code
, posta adresini vermek için kullanılan bir posta kodunu belirtir ülke içinde posta gönderin.natural_feature
belirgin bir doğal özelliği gösterir.airport
, havaalanını gösterir.park
, adlandırılmış bir parkı gösterir.point_of_interest
, adlandırılmış bir önemli yeri gösterir. Bu "ÖY"ler, genellikle bir yere kolayca sığmayan belirgin yerel varlıklardır "Empire State Binası" gibi başka bir kategoride veya "Eyfel Kulesi".
Boş bir tür listesi, belirli bir adres bileşeni (ör. Fransa'daki Lieu-dit) için bilinen tür olmadığını gösterir.
Adres bileşenleri, yukarıdakilere ek olarak burada listelenen türleri de içerebilir. Bu liste tam kapsamlı değildir ve değişebilir.
floor
, bir bina adresinin katını gösterir.establishment
, genellikle henüz ziyaret edilmeyen yerleri gösterir kategorize edildi.landmark
, referans olarak kullanılan yakındaki bir yeri gösterir. yardımcı olan araçlardır.point_of_interest
, adlandırılmış bir önemli yeri gösterir.parking
, bir otopark veya otopark yapısını gösterir.post_box
, belirli bir posta kutusunu gösterir.postal_town
,locality
vesublocality
, posta adresleri için kullanılır bazı ülkelerde.room
, bina adresinin bulunduğu odayı gösterir.street_number
tam sokak numarasını gösterir.bus_station
,train_station
vetransit_station
otobüs, tren veya halka açık yerleri belirtir toplu taşıma durağı.
Görüntü alanını etkileme
Bir Coğrafi Kodlama isteğinde, Coğrafi Kodlama hizmetine ilk olarak
belirli bir görüntü alanı içindeki sonuçlar (sınırlayıcı kutu olarak ifade edilir). Teklifiniz doğrultusunda
bounds
parametresini ayarlayarak istek URL'sinin içinde olmasını sağlayabilirsiniz.
bounds
parametresi enlem/boylam koordinatlarını tanımlar
bu sınırlayıcı kutunun güneybatı ve kuzeydoğu köşelerinin bir boru kullanılarak
(|
) karakteri ekleyin.
Örneğin, "Washington" için coğrafi kod genellikle ABD’deki Washington:
İstek:
https://maps.googleapis.com/maps/api/geocode/json?address=Washington&key=YOUR_API_KEY
Yanıt:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Washington",
"short_name" : "WA",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Washington, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 49.0024442,
"lng" : -116.91558
},
"southwest" : {
"lat" : 45.543541,
"lng" : -124.8489739
}
},
"location" : {
"lat" : 47.7510741,
"lng" : -120.7401385
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 49.0024442,
"lng" : -116.91558
},
"southwest" : {
"lat" : 45.543541,
"lng" : -124.8489739
}
}
},
"place_id" : "ChIJ-bDD5__lhVQRuvNfbGh4QpQ",
"types" : [ "administrative_area_level_1", "political" ]
}
],
"status" : "OK"
}
Ancak ABD'nin kuzeydoğu kesimi etrafında bir sınır kutusu tanımlayan bir bounds
bağımsız değişkeni eklemek, bu coğrafi kodda Washington, D.C. şehrinin döndürülmesine neden olur:
İstek:
https://maps.googleapis.com/maps/api/geocode/json?address=Washington&bounds=36.47,-84.72%7C43.39,-65.90&key=YOUR_API_KEY
Yanıt:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Washington",
"short_name" : "Washington",
"types" : [ "locality", "political" ]
},
{
"long_name" : "District of Columbia",
"short_name" : "District of Columbia",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "District of Columbia",
"short_name" : "DC",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Washington, DC, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 38.9958641,
"lng" : -76.90939299999999
},
"southwest" : {
"lat" : 38.7916449,
"lng" : -77.119759
}
},
"location" : {
"lat" : 38.9071923,
"lng" : -77.03687069999999
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 38.9958641,
"lng" : -76.90939299999999
},
"southwest" : {
"lat" : 38.7916449,
"lng" : -77.119759
}
}
},
"place_id" : "ChIJW-T2Wt7Gt4kRKl2I1CJFUsI",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
Bölgeye ağırlık verme
Coğrafi kodlama isteğinde, region
parametresini kullanarak Coğrafi Kodlama hizmetine belirli bir bölgeye yönelik sonuçlar döndürmesi için talimat verebilirsiniz. Bu parametre bir ccTLD (ülke kodu üst düzey) alır
alan) bağımsız değişkeninin önüne geçin. Çoğu ccTLD kodu
ISO 3166-1 kodları (bazı önemli istisnalarla birlikte). Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk
) iken ISO 3166-1 kodu "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için).
Coğrafi kodlama sonuçları, ana verinin kullanıldığı her alan adında Google Haritalar uygulaması resmi olarak kullanıma sunuldu. Eğilimlendirmenin yalnızca belirli bir alanla ilgili sonuçları tercih ettiğini unutmayın. Bu alanın dışında daha alakalı sonuçlar varsa bunlar da dahil edilebilir.
Örneğin, Geocoding API'nin varsayılan alanı ABD olarak ayarlandığından "Toledo" için bir coğrafi kod bu sonucu döndürür. İstek:
https://maps.googleapis.com/maps/api/geocode/json?address=Toledo&key=YOUR_API_KEY
Yanıt:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Toledo",
"short_name" : "Toledo",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Lucas County",
"short_name" : "Lucas County",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Ohio",
"short_name" : "OH",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, OH, USA",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 41.732844,
"lng" : -83.454229
},
"southwest" : {
"lat" : 41.580266,
"lng" : -83.69423700000002
}
},
"location" : {
"lat" : 41.6639383,
"lng" : -83.55521200000001
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 41.732844,
"lng" : -83.454229
},
"southwest" : {
"lat" : 41.580266,
"lng" : -83.69423700000002
}
}
},
"place_id" : "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
region=es
(İspanya) ile "Toledo" için bir Coğrafi Kodlama isteği, İspanya'daki şehri döndürür.
İstek:
https://maps.googleapis.com/maps/api/geocode/json?address=Toledo®ion=es&key=YOUR_API_KEY
Yanıt:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Toledo",
"short_name" : "Toledo",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Toledo",
"short_name" : "TO",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Castile-La Mancha",
"short_name" : "CM",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "Spain",
"short_name" : "ES",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Toledo, Spain",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 39.88605099999999,
"lng" : -3.9192423
},
"southwest" : {
"lat" : 39.8383676,
"lng" : -4.0796176
}
},
"location" : {
"lat" : 39.8628316,
"lng" : -4.027323099999999
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 39.88605099999999,
"lng" : -3.9192423
},
"southwest" : {
"lat" : 39.8383676,
"lng" : -4.0796176
}
}
},
"place_id" : "ChIJ8f21C60Lag0R_q11auhbf8Y",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
Bileşen filtreleme
Coğrafi Kodlama yanıtında, Coğrafi Kodlama API'si adres döndürebilir
sonuç belirli bir alanla sınırlandırıldı. components
filtresini kullanarak kısıtlamayı belirtebilirsiniz. Filtre, boru (|
) ile ayrılmış component:value
çiftlerinin bir listesinden oluşur. Filtre değerleri, diğer coğrafi kodlama istekleriyle aynı yazım düzeltme ve kısmi eşleme yöntemlerini destekler. Coğrafi kodlayıcı,
bileşen filtresini uyguladığınızda yanıt bir partial_match
alanı içerir.
Filtrelenebilir components
şunlardır:
postal_code
,postal_code
ile eşleşir vepostal_code_prefix
.country
, bir ülke adıyla veya iki harfli ISO 3166-1 ülke koduyla eşleşir. API, Google Etiket Yöneticisi'nin en iyi sonucu verir. Filtre, ülkenin ilgili ISO kodu.
Aşağıdaki components
, sonuçları etkilemek için kullanılabilir, ancak
zorunlu kılınan:
route
, bir rotanın uzun veya kısa adıyla eşleşir.locality
ilelocality
eşleşir vesublocality
tür.administrative_area
,administrative_area
seviye.
Bileşen filtreleme hakkında notlar:
- Bu bileşen filtrelerini isteklerde tekrarlamayın. Aksi takdirde API,
Invalid_request
:country
,postal_code
,route
- İstek yinelenen bileşen filtreleri içeriyorsa API bunları değerlendirir ifadesini OR olarak değil, AND olarak filtreler.
- Sonuçlar Google Haritalar ile tutarlıdır. Google Haritalar, zaman zaman
beklenmeyen
ZERO_RESULTS
yanıt. Yer otomatik tamamlama özelliğini kullanmak bazı kullanım alanlarında daha iyi sonuçlar sağlayabilir. Daha fazla bilgi edinmek için bkz. bu SSS. - Her bir adres bileşeni için bunu
address
içinde belirtin parametresinde veyacomponents
filtresinde kullanılabilir. Belirtme her ikisinde de aynı değerlerZERO_RESULTS
ile sonuçlanabilir.
components=country:GB
ile "High St, Hastings" için bir coğrafi kod, ABD'deki Hastings-On-Hudson yerine İngiltere'deki Hastings'te bir sonuç döndürür.
İstek:
https://maps.googleapis.com/maps/api/geocode/json?address=high+st+hasting&components=country:GB&key=YOUR_API_KEY
Yanıt:
{
"results" : [
{
"address_components" : [
{
"long_name" : "High Street",
"short_name" : "High St",
"types" : [ "route" ]
},
{
"long_name" : "Hastings",
"short_name" : "Hastings",
"types" : [ "postal_town" ]
},
{
"long_name" : "East Sussex",
"short_name" : "East Sussex",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "England",
"short_name" : "England",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "United Kingdom",
"short_name" : "GB",
"types" : [ "country", "political" ]
},
{
"long_name" : "TN34 3EY",
"short_name" : "TN34 3EY",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "High St, Hastings TN34 3EY, UK",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 50.8601041,
"lng" : 0.5957329
},
"southwest" : {
"lat" : 50.8559061,
"lng" : 0.5906163
}
},
"location" : {
"lat" : 50.85830319999999,
"lng" : 0.5924594
},
"location_type" : "GEOMETRIC_CENTER",
"viewport" : {
"northeast" : {
"lat" : 50.8601041,
"lng" : 0.5957329
},
"southwest" : {
"lat" : 50.8559061,
"lng" : 0.5906163
}
}
},
"partial_match" : true,
"place_id" : "ChIJ-Ws929sa30cRKgsMNVkPyws",
"types" : [ "route" ]
}
],
"status" : "OK"
}
"Santa Cruz"un konumu için coğrafi kod isteği components=country:ES
ile birlikte
İspanya'nın Kanarya Adaları'ndan Santa Cruz de Tenerife'i iade ediyor.
İstek:
https://maps.googleapis.com/maps/api/geocode/json?components=locality:santa+cruz|country:ES&key=YOUR_API_KEY
Yanıt:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Santa Cruz de Tenerife",
"short_name" : "Santa Cruz de Tenerife",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Santa Cruz de Tenerife",
"short_name" : "TF",
"types" : [ "administrative_area_level_2", "political" ]
},
{
"long_name" : "Canary Islands",
"short_name" : "CN",
"types" : [ "administrative_area_level_1", "political" ]
},
{
"long_name" : "Spain",
"short_name" : "ES",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "Santa Cruz de Tenerife, Spain",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 28.487616,
"lng" : -16.2356646
},
"southwest" : {
"lat" : 28.4280248,
"lng" : -16.3370045
}
},
"location" : {
"lat" : 28.4636296,
"lng" : -16.2518467
},
"location_type" : "APPROXIMATE",
"viewport" : {
"northeast" : {
"lat" : 28.487616,
"lng" : -16.2356646
},
"southwest" : {
"lat" : 28.4280248,
"lng" : -16.3370045
}
}
},
"place_id" : "ChIJcUElzOzMQQwRLuV30nMUEUM",
"types" : [ "locality", "political" ]
}
],
"status" : "OK"
}
Bileşen filtreleme ZERO_RESULTS
yanıtı döndürüyor
yalnızca birbirini hariç tutan filtreler sağlamanız gerekir.
İstek:
https://maps.googleapis.com/maps/api/geocode/json?components=administrative_area:TX|country:FR&key=YOUR_API_KEY
Yanıt:
{
"results" : [],
"status" : "ZERO_RESULTS"
}
Adres parametresi olmadan
components
filtresi. (Bir tam adresin coğrafi kodlamasını yaparken,
İstekaddress
binaların adlarını ve numaralarını yazın.)
İstek:
https://maps.googleapis.com/maps/api/geocode/json?components=route:Annankatu|administrative_area:Helsinki|country:Finland&key=YOUR_API_KEY
Yanıt:
{
"results" : [
{
"address_components" : [
{
"long_name" : "Annankatu",
"short_name" : "Annankatu",
"types" : [ "route" ]
},
{
"long_name" : "Helsinki",
"short_name" : "HKI",
"types" : [ "locality", "political" ]
},
{
"long_name" : "Finland",
"short_name" : "FI",
"types" : [ "country", "political" ]
},
{
"long_name" : "00101",
"short_name" : "00101",
"types" : [ "postal_code" ]
}
],
"formatted_address" : "Annankatu, 00101 Helsinki, Finland",
"geometry" : {
"bounds" : {
"northeast" : {
"lat" : 60.168997,
"lng" : 24.9433353
},
"southwest" : {
"lat" : 60.16226160000001,
"lng" : 24.9332897
}
},
"location" : {
"lat" : 60.1657808,
"lng" : 24.938451
},
"location_type" : "GEOMETRIC_CENTER",
"viewport" : {
"northeast" : {
"lat" : 60.168997,
"lng" : 24.9433353
},
"southwest" : {
"lat" : 60.16226160000001,
"lng" : 24.9332897
}
}
},
"place_id" : "ChIJARW7C8sLkkYRgl4je4-RPUM",
"types" : [ "route" ]
}
],
"status" : "OK"
}