Otomatik Sorgu Tamamlama (Eski)

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Query Autocomplete (Legacy), siz yazarken önerilen sorguları döndürerek metin tabanlı coğrafi aramalar için sorgu tahmini sağlamak amacıyla kullanılabilir.

Query Autocomplete (Eski) istekleri

Query Autocomplete (Eski), Places API'nin (Eski) bir parçasıdır ve Places API (Eski) ile bir API anahtarı ve kotayı paylaşır.

Query Autocomplete (Eski), uygulamanıza anında coğrafi sorgu tahminleri eklemenize olanak tanır. Kullanıcı belirli bir konum aramak yerine "New York yakınlarında pizza" gibi kategorik bir arama yazabilir ve hizmet, dizeyle eşleşen önerilen sorguların bir listesini döndürür. Sorgu Otomatik Tamamlama (Eski) hem tam kelimelerle hem de alt dizelerle eşleşebildiğinden, uygulamalar kullanıcı yazarken sorgu göndererek anında tahminler sunabilir.

Query Autocomplete (Legacy) isteği, aşağıdaki biçimde bir HTTP URL'sidir:

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

Burada output, json veya xml olabilir.

Query Autocomplete (Legacy) 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. Parametrelerin listesi ve olası değerleri aşağıda sıralanmıştır.

Gerekli parametreler

giriş

Aranacak metin dizesi. Yer Adı Otomatik Tamamlama hizmeti, bu dizeye göre eşleşme adayları döndürür ve sonuçları algılanan alaka düzeylerine göre sıralar.

İsteğe bağlı parametreler

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 tercih edilen dili dikkate alarak açık adresleri yerel dilde döndürür ve gerekirse kullanıcının okuyabileceği 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. Örneğin, Macarcada utca ve tér, sokak kelimesinin eş anlamlılarıdır.

konum

Aramanın yapılacağı noktayı latitude,longitude koordinatları olarak tanımlar. Places hizmeti, aramayı location ve radius ile tanımlanan alandaki sonuçları gösterecek şekilde yönlendirmek için konumu kullanır. Tanımlanan alanın dışındaki sonuçlar da gösterilebilir.

query, Market in Barcelona gibi açık bir konum içeriyorsa location parametresi geçersiz kılınabilir. Sorguyu tırnak içine almak, location ve radius öğelerine verilen ağırlığı da etkileyebilir.

telafi etmek

Hizmetin tahminleri eşleştirmek için kullandığı son karakterin giriş terimindeki konumu. Örneğin, giriş Google ve ofset 3 ise hizmet Goo ile eşleşir. Ofset tarafından belirlenen dize, yalnızca giriş terimindeki ilk kelimeyle eşleştirilir. Örneğin, giriş terimi Google abc ve ofset 3 ise hizmet, Goo abc ile eşleştirmeye çalışır. Herhangi bir fark sağlanmazsa hizmet, tüm terimi kullanır. Ofset genellikle metin imlecinin konumuna ayarlanmalıdır.

yarıçap

Yer sonuçlarının döndürüleceği mesafeyi (metre cinsinden) tanımlar. Bir location ve radius parametresi ileterek sonuçları belirli bir daireye yönlendirebilirsiniz. Bunu yaptığınızda Places hizmetine, sonuçları bu daire içinde göstermeyi tercih etmesi talimatı verilir. Tanımlanan alanın dışındaki sonuçlar da gösterilebilir.

Yarıçap, arama türüne ve diğer parametrelere bağlı olarak otomatik olarak maksimum bir değerle sınırlandırılır.

  • Otomatik tamamlama: 50.000 metre
  • Yakında Arama:
    • keyword veya name ile: 50.000 metre
    • keyword veya name olmadan
      • rankby parametresinden bağımsız olarak, alan yoğunluğuna göre dinamik olarak ayarlanan, en fazla 50.000 metre.
      • rankby=distance kullanılırken yarıçap parametresi kabul edilmez ve INVALID_REQUEST hatasına neden olur.
  • Query Autocomplete: 50.000 metre
  • Metin Arama: 50.000 metre

Query Autocomplete (Eski) örnekleri

URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

"Paris yakınlarında pizza" isteği, Fransızca sonuçlarla:

URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &language=fr
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&language=fr&key=YOUR_API_KEY'

Bu örneklerdeki API anahtarını kendi anahtarınızla değiştirmeniz gerektiğini unutmayın.

Query Autocomplete (Eski) yanıtı

Sorgu Otomatik Tamamlama (Eski) yanıtları, URL isteğinin yolundaki output işaretiyle belirtilen biçimde döndürülür. Aşağıdaki sonuçlar, şu parametreleri içeren bir sorgu için döndürülür:

URL

https://maps.googleapis.com/maps/api/place/queryautocomplete/json
  ?input=pizza%20near%20par
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/queryautocomplete/json?input=pizza%20near%20par&key=YOUR_API_KEY'

JSON

{
  "predictions":
    [
      {
        "description": "pizza near Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris" },
            { "offset": 18, "value": "France" },
          ],
      },
      {
        "description": "pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Pari Chowk" },
            { "offset": 23, "value": "NRI City" },
            { "offset": 33, "value": "Omega II" },
            { "offset": 43, "value": "Noida" },
            { "offset": 50, "value": "Uttar Pradesh" },
            { "offset": 65, "value": "India" },
          ],
      },
      {
        "description": "pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 22 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Disneyland Park, Disneyland Drive, Anaheim, CA, USA",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 16 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Disneyland Park" },
            { "offset": 28, "value": "Disneyland Drive" },
            { "offset": 46, "value": "Anaheim" },
            { "offset": 55, "value": "CA" },
            { "offset": 59, "value": "USA" },
          ],
      },
      {
        "description": "pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 36 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France",
            "secondary_text_matched_substrings":
              [{ "length": 3, "offset": 30 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Cathédrale Notre-Dame de Paris" },
            { "offset": 43, "value": "Parvis Notre-Dame - place Jean-Paul-II" },
            { "offset": 83, "value": "Paris" },
            { "offset": 90, "value": "France" },
          ],
      },
      {
        "description": "pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
        "matched_substrings":
          [{ "length": 5, "offset": 0 }, { "length": 3, "offset": 11 }],
        "structured_formatting":
          {
            "main_text": "pizza",
            "main_text_matched_substrings": [{ "length": 5, "offset": 0 }],
            "secondary_text": "near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France",
            "secondary_text_matched_substrings": [{ "length": 3, "offset": 5 }],
          },
        "terms":
          [
            { "offset": 0, "value": "pizza" },
            { "offset": 6, "value": "near" },
            { "offset": 11, "value": "Paris Beauvais Airport" },
            { "offset": 35, "value": "Route de l'Aéroport" },
            { "offset": 56, "value": "Tillé" },
            { "offset": 63, "value": "France" },
          ],
      },
    ],
  "status": "OK",
}
    

XML

      
<AutocompletionResponse>
 <status>OK</status>
 <prediction>
  <description>pizza near Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>France</value>
   <offset>18</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Pari Chowk</value>
   <offset>11</offset>
  </term>
  <term>
   <value>NRI City</value>
   <offset>23</offset>
  </term>
  <term>
   <value>Omega II</value>
   <offset>33</offset>
  </term>
  <term>
   <value>Noida</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Uttar Pradesh</value>
   <offset>50</offset>
  </term>
  <term>
   <value>India</value>
   <offset>65</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Pari Chowk, NRI City, Omega II, Noida, Uttar Pradesh, India</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Disneyland Park</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Disneyland Drive</value>
   <offset>28</offset>
  </term>
  <term>
   <value>Anaheim</value>
   <offset>46</offset>
  </term>
  <term>
   <value>CA</value>
   <offset>55</offset>
  </term>
  <term>
   <value>USA</value>
   <offset>59</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>22</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Disneyland Park, Disneyland Drive, Anaheim, CA, USA</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>16</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Cathédrale Notre-Dame de Paris</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Parvis Notre-Dame - place Jean-Paul-II</value>
   <offset>43</offset>
  </term>
  <term>
   <value>Paris</value>
   <offset>83</offset>
  </term>
  <term>
   <value>France</value>
   <offset>90</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>36</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Cathédrale Notre-Dame de Paris, Parvis Notre-Dame - place Jean-Paul-II, Paris, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>30</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
 <prediction>
  <description>pizza near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</description>
  <term>
   <value>pizza</value>
   <offset>0</offset>
  </term>
  <term>
   <value>near</value>
   <offset>6</offset>
  </term>
  <term>
   <value>Paris Beauvais Airport</value>
   <offset>11</offset>
  </term>
  <term>
   <value>Route de l'Aéroport</value>
   <offset>35</offset>
  </term>
  <term>
   <value>Tillé</value>
   <offset>56</offset>
  </term>
  <term>
   <value>France</value>
   <offset>63</offset>
  </term>
  <matched_substring>
   <offset>0</offset>
   <length>5</length>
  </matched_substring>
  <matched_substring>
   <offset>11</offset>
   <length>3</length>
  </matched_substring>
  <structured_formatting>
   <description>pizza</description>
   <subdescription>near Paris Beauvais Airport, Route de l'Aéroport, Tillé, France</subdescription>
   <description_matched_substring>
    <offset>0</offset>
    <length>5</length>
   </description_matched_substring>
   <subdescription_matched_substring>
    <offset>5</offset>
    <length>3</length>
   </subdescription_matched_substring>
  </structured_formatting>
 </prediction>
</AutocompletionResponse>
    
   

Places hizmeti, bir aramadan JSON sonuçları döndürdüğünde bunları bir predictions dizisine yerleştirir. Hizmet sonuç döndürmese bile (ör. location uzaksa) boş bir predictions dizisi döndürür. XML yanıtları sıfır veya daha fazla <prediction> öğesinden oluşur.

PlacesQueryAutocompleteResponse

Alan Zorunlu Tür Açıklama
required Array<PlaceAutocompletePrediction>

Bir tahmin dizisi içerir.

Daha fazla bilgi için PlaceAutocompletePrediction sayfasına bakın.

required PlacesAutocompleteStatus

İsteğin durumunu içerir ve isteğin neden başarısız olduğunu bulmanıza yardımcı olacak hata ayıklama bilgilerini içerebilir.

Daha fazla bilgi için PlacesAutocompleteStatus sayfasına bakın.

isteğe bağlı dize

Hizmet OK dışında bir durum kodu döndürdüğünde, yanıt nesnesinde ek bir error_message alanı olabilir. Bu alan, verilen durum kodunun nedenleri hakkında daha ayrıntılı bilgi içerir. Bu alan her zaman döndürülmez ve içeriği değişebilir.

isteğe bağlı Dizi<string>

Hizmet, istek spesifikasyonu hakkında ek bilgi döndürdüğünde yanıt nesnesinde ek bir info_messages alanı olabilir. Bu alan yalnızca başarılı istekler için döndürülür. Her zaman döndürülmeyebilir ve içeriği değişebilir.

PlacesAutocompleteStatus

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

  • API isteğinin başarılı olduğunu gösteren OK.
  • ZERO_RESULTS, aramanın başarılı olduğunu ancak sonuç döndürmediğini gösterir. Bu durum, arama uzak bir konumdaki bir sınıra iletildiğinde ortaya çıkabilir.
  • API isteğinin hatalı biçimlendirildiğini gösteren INVALID_REQUEST. Bu durum genellikle input parametresinin eksik olmasından kaynaklanır.
  • OVER_QUERY_LIMIT Aşağıdakilerden herhangi birini gösteren:
    • 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 (örneğin, 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.

Places hizmeti, bir aramadan JSON sonuçları döndürdüğünde bunları bir predictions dizisine yerleştirir. Hizmet sonuç döndürmese bile (ör. location uzaksa) boş bir predictions dizisi döndürür. XML yanıtları sıfır veya daha fazla <prediction> öğesinden oluşur.

PlaceAutocompletePrediction

Alan Zorunlu Tür Açıklama
required dize

Döndürülen sonucun kullanıcı tarafından okunabilen adını içerir. establishment sonuçları için bu genellikle işletme adıdır. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın.

required Array<PlaceAutocompleteMatchedSubstring>

Tahmin sonucu metninde girilen terimin konumunu açıklayan alt dizelerin listesi. Bu sayede, istenirse terim vurgulanabilir.

Daha fazla bilgi için PlaceAutocompleteMatchedSubstring sayfasına bakın.

required PlaceAutocompleteStructuredFormat

Otomatik tamamlama sonuçlarınızda gösterilebilecek önceden biçimlendirilmiş metin sağlar. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın.

Daha fazla bilgi için PlaceAutocompleteStructuredFormat bölümüne bakın.

required Array<PlaceAutocompleteTerm>

Döndürülen açıklamanın her bölümünü tanımlayan bir terim dizisi içerir (açıklamanın bir bölümü genellikle virgülle sonlandırılır). Dizideki her giriş, terimin metnini içeren bir value alanına ve bu terimin açıklamadaki başlangıç konumunu tanımlayan bir offset alanına sahiptir. Bu alan, Unicode karakterlerle ölçülür.

Daha fazla bilgi için PlaceAutocompleteTerm sayfasına bakın.

isteğe bağlı tam sayı

Başlangıç noktasından metre cinsinden düz çizgi mesafesi. Bu alan yalnızca origin ile yapılan istekler için döndürülür.

isteğe bağlı dize

Bir yeri benzersiz şekilde tanımlayan metin tanımlayıcı. Yerle ilgili bilgileri almak için bu tanımlayıcıyı bir Places API isteğinin placeId alanına iletin. Yer kimlikleri hakkında daha fazla bilgi için Yer Kimlikleri genel bakış sayfasını inceleyin.

isteğe bağlı dize

place_id bölümüne bakın.

isteğe bağlı Dizi<string>

Bu yer için geçerli olan türlerin bir dizisini içerir. Örneğin: [ "political", "locality" ] veya [ "establishment", "geocode", "beauty_salon" ]. Dizi, birden fazla değer içerebilir. Yer türleri hakkında daha fazla bilgi edinin.

PlaceAutocompleteMatchedSubstring

Alan Zorunlu Tür Açıklama
required sayı

Tahmin sonucu metnindeki eşleşen alt dizenin uzunluğu.

required sayı

Tahmin sonucu metninde eşleşen alt dizenin başlangıç konumu.

PlaceAutocompleteStructuredFormat

Alan Zorunlu Tür Açıklama
required dize

Tahminin ana metnini (genellikle yerin adını) içerir.

required Array<PlaceAutocompleteMatchedSubstring>

offset değeri ve length içeren bir dizi içerir. Bunlar, girilen terimin tahmin sonucu metnindeki konumunu açıklar. Böylece, istenirse terim vurgulanabilir.

Daha fazla bilgi için PlaceAutocompleteMatchedSubstring sayfasına bakın.

isteğe bağlı dize

Bir tahminin ikincil metnini (genellikle yerin konumu) içerir.

isteğe bağlı Array<PlaceAutocompleteMatchedSubstring>

offset değeri ve length içeren bir dizi içerir. Bunlar, girilen terimin tahmin sonucu metnindeki konumunu açıklar. Böylece, istenirse terim vurgulanabilir.

Daha fazla bilgi için PlaceAutocompleteMatchedSubstring sayfasına bakın.

PlaceAutocompleteTerm

Alan Zorunlu Tür Açıklama
required sayı

Bu terimin açıklamadaki başlangıç konumunu tanımlar (Unicode karakterlerle ölçülür)

required dize

Terimin metni.