Yer Bulma (Eski)

Find Place (Eski) isteği, metin girişi alır ve bir yer döndürür. Giriş, ad, adres veya telefon numarası gibi herhangi bir türde Yerler metin verisi olabilir. İstek bir dize olmalıdır. Dize olmayan veriler (ör. enlem/boylam koordinatı veya Plus Code) kullanan bir Find Place (Eski) isteği hata oluşturur.

Find Place (Legacy) istekleri

Find Place (Eski) isteği, aşağıdaki biçimde bir HTTP URL'sidir:

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

Burada output, aşağıdaki değerlerden biri olabilir:

• json (önerilen), JavaScript Object Notation (JSON) biçiminde çıkış yapılacağını belirtir.
• xml, çıkışın XML biçiminde olduğunu gösterir.

Yer Bulma (Eski) isteği başlatmak için belirli parametreler gereklidir. URL'lerde standart olduğu gibi, tüm parametreler ve işareti (&) karakteri kullanılarak ayrılır.

Gerekli parametreler

• giriş

  Aranacak metin dizesi. Bu, bir yer adı, adres veya telefon numarası olmalıdır (örneğin, "Atatürk Caddesi No: 123" veya "Belediye Binası").

• inputtype

  Giriş türü. Bu, textquery veya phonenumber olabilir. Telefon numaraları uluslararası standartta olmalıdır (artı işareti ("+"), ardından ülke kodu ve telefon numarası). Daha fazla bilgi için E.164 ITU önerisine bakın.

İsteğe bağlı parametreler

• Fields

  Dikkat: Yer Arama (Eski) istekleri ve Yer Ayrıntıları (Eski) istekleri aynı alanları döndürmez. Yer Arama (Eski) istekleri, Yer Ayrıntıları (Eski) istekleri tarafından döndürülen alanların bir alt kümesini döndürür. İstediğiniz alan Yer Arama (Eski) tarafından döndürülmüyorsa Yer Arama (Eski) kullanarak bir place_id alabilir, ardından bu yer kimliğini kullanarak Yer Ayrıntıları (Eski) isteği gönderebilirsiniz. Yer Arama (Eski) isteğinde kullanılamayan alanlar hakkında daha fazla bilgi için Places API alan desteği başlıklı makaleyi inceleyin.

  Döndürülecek yer verisi türlerinin virgülle ayrılmış listesini belirtmek için fields parametresini kullanın. Örneğin: fields=formatted_address,name,geometry. Bileşik değerleri belirtirken eğik çizgi kullanın. Örneğin: opening_hours/open_now.

  Alanlar üç faturalandırma kategorisine ayrılır: Temel, İletişim ve Atmosfer. Temel alanlar taban fiyattan, İletişim ve Atmosfer alanları ise daha yüksek bir fiyattan faturalandırılır. Temel, İletişim ve Atmosfer SKU'ları, bunları tetikleyen istek için temel SKU'ya (Yer Ayrıntıları, Yer Bul, Yakında Arama veya Metin Arama) ek olarak ücretlendirilir. Daha fazla bilgi için fiyatlandırma sayfasına bakın.

  Temel

  Temel kategorisi şu alanları içerir: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (desteği sonlandırıldı), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  İletişim

  İletişim kategorisi şu alanları içerir: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

  Atmosfer

  Atmosfer kategorisi şu alanları içerir: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

  Not: Atıflar (html_attributions), alanın istenip istenmediğine bakılmaksızın her çağrıda her zaman döndürülür.

• 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 kapsamlı olmayabilir.
  • language sağlanmazsa API, Accept-Language başlığında belirtilen tercih edilen dili kullanmaya çalışır.
  • API, 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 açık adresleri yerel dilde döndürür ve gerekirse tercih edilen dili dikkate alarak kullanıcı tarafından okunabilir bir alfabeye dönüştü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 dilde döndürülür.
  • Tercih edilen dilde bir ad yoksa API en yakın eşleşmeyi kullanır.
  • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. 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ı kelimeler buna dahildir. Örneğin, Macarcada utca ve tér kelimeleri "sokak" anlamına gelir.

• locationbias

  Bir yarıçap ve enlem/boylam ya da bir dikdörtgenin noktalarını temsil eden iki enlem/boylam çifti belirterek belirli bir alandaki sonuçları tercih edin. Bu parametre belirtilmezse API, varsayılan olarak IP adresi ağırlıklandırmasını kullanır.

  • IP bias: API'ye IP adresi yönlendirmesini kullanma talimatı verir. ipbias dizesini iletin (bu seçeneğin ek parametreleri yoktur).
  • Dairesel: Metre cinsinden yarıçapı ve ondalık derece cinsinden enlem/boylamı belirten bir dize. Şu biçimi kullanın: circle:radius@lat,lng.
  • Dikdörtgen: Bir dikdörtgenin güney/batı ve kuzey/doğu noktalarını temsil eden, ondalık derece cinsinden iki enlem/boylam çiftini belirten bir dize. Aşağıdaki biçimi kullanın:rectangle:south,west|north,east. Doğu/batı değerlerinin -180, 180 aralığına sığdırıldığını ve kuzey/güney değerlerinin -90, 90 aralığına sabitlendiğini unutmayın.

Find Place (Legacy) örnekleri

Aşağıdaki örnekte, photos, formatted_address, name, rating, opening_hours ve geometry alanlarını içeren "Museum of Contemporary Art Australia" için bir Yer Bulma (Eski) isteği gösterilmektedir:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

Aşağıdaki örnekte, "Mongolian Grill" için bir Yer Bulma (Eski) isteği gösterilmektedir. Belirtilen koordinatların 2.000 metre yakınındaki sonuçları tercih etmek için locationbias parametresi kullanılmıştır:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

Aşağıdaki örnekte, telefon numarası için Find Place (Legacy) isteği gösterilmektedir. Bu isteğin uyumlu bir URL olması için uluslararası arama öneki olan "+" karakterinin %2B olarak kodlandığını unutmayın. Kodlanmadan bırakılırsa + öneki sunucuda boşluk olarak çözülür ve geçersiz bir telefon numarası aramasıyla sonuçlanır.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Find Place (Legacy) yanıtları

Yer Bulma (Eski) yanıtı, yalnızca fields parametresi kullanılarak belirtilen veri türlerini ve html_attributions değerini içerir. Aşağıdaki örnekte, "Museum of Contemporary Art Australia" için yapılan bir Yer Bulma (Eski) isteğinin yanıtı gösterilmektedir. Bu yanıtta formatted_address, geometry, name, opening_hours, photos, rating alanları yer alır.

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

PlacesSearchStatus

Hizmet tarafından döndürülen durum kodları.

• API isteğinin başarılı olduğunu gösteren OK.
• Aramanın başarılı olduğunu ancak sonuç döndürmediğini gösteren ZERO_RESULTS. Bu durum, aramaya uzak bir konumda latlng iletildiğinde ortaya çıkabilir.
• API isteğinin hatalı biçimlendirildiğini gösteren INVALID_REQUEST. Bu durum genellikle gerekli sorgu parametresinin (location veya radius) eksik olmasından kaynaklanır.
• OVER_QUERY_LIMIT Aşağıdakilerden herhangi birini belirten:
  • QPS sınırlarını aştınız.
  • Hesabınızda faturalandırma etkinleştirilmemiştir.
  • Aylık 200 ABD doları tutarındaki kredi veya kendi belirlediğiniz kullanım sınırı aşılmıştır.
  • Sağlanan ödeme yöntemi artık geçerli değilse (ör. kredi kartının süresi dolmuşsa)
  Bu hatanın nasıl çözüleceği hakkında daha fazla bilgi için Haritalar SSS sayfasını inceleyin.
• REQUEST_DENIED genellikle şu nedenlerle isteğinizin reddedildiğini belirtir:
  • İstekte API anahtarı eksik.
  • key parametresi geçersiz.
• Bilinmeyen bir hatayı gösteren UNKNOWN_ERROR.

Yer

Yer Arama yanıtları, Place alanlarının aşağıdaki alt kümesini döndürür. Tüm özellikler her yer türü için kullanılamaz. Yer Arama'nın döndürmediği address_components, formatted_phone_number, reviews veya website gibi alanları almak için döndürülen place_id değerini bir Yer Ayrıntıları (Eski) isteğinde iletin. Uç noktalardaki alan kullanılabilirliği ve fiyatlandırma katmanları için Yer Veri Alanları (Eski) başlıklı makaleyi inceleyin.