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.
-
languagesağlanmazsa API,Accept-Languagebaş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:
keywordveyanameile: 50.000 metre-
keywordveyanameolmadan-
rankbyparametresinden bağımsız olarak, alan yoğunluğuna göre dinamik olarak ayarlanan, en fazla 50.000 metre. -
rankby=distancekullanılırken yarıçap parametresi kabul edilmez veINVALID_REQUESThatası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 |
|
isteğe bağlı | Dizi<string> |
Hizmet, istek spesifikasyonu hakkında ek bilgi döndürdüğünde yanıt nesnesinde ek bir |
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 genellikleinputparametresinin eksik olmasından kaynaklanır. -
OVER_QUERY_LIMITAş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)
-
REQUEST_DENIEDgenellikle şu nedenlerle isteğinizin reddedildiğini belirtir:- İstekte API anahtarı eksik.
keyparametresi 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. |
|
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 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 |
|
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:
|
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> |
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> |
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. |