Siz yazarken önerilen sorguları döndürerek metin tabanlı coğrafi aramalar için sorgu tahmini sağlamak üzere Sorgu Otomatik Tamamlama (Eski) kullanılabilir.
Otomatik Sorgu Tamamlama (Eski) istekleri
Query Autocomplete (Eski), Places API'nin (Eski) bir parçasıdır ve Places API (Eski) ile API anahtarı ve kota paylaşır.
Query Autocomplete (Legacy), uygulamanıza anında coğrafi sorgu tahminleri eklemenize olanak tanır. Kullanıcılar belirli bir konumu aramak yerine "New York yakınlarında pizza" gibi kategorik bir arama yapabilir ve hizmet, dizeyle eşleşen önerilen sorguların listesini yanıt olarak verir. Sorgu Otomatik Tamamlama (Eski), hem tam kelimeler hem de alt dizelerle eşleşebildiğinden uygulamalar, kullanıcı yazarken sorguları göndererek anında tahminler sağlayabilir.
Bir sorgu otomatik tamamlama (eski) 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.
Otomatik Tamamlama (Eski) isteği başlatmak için belirli parametreler gereklidir.
URL'lerde standart olduğu gibi, tüm parametreler "ve" işareti (&) kullanılarak ayrılır. Parametrelerin listesi ve olası değerleri aşağıda sıralanmıştır.
Gerekli parametreler
-
giriş
Arama yapılacak metin dizesi. Yer Adı Otomatik Tamamlama hizmeti, bu dizeye göre olası eşleşmeleri 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ği için bu liste kapsamlı olmayabilir.
-
languagesağlanmazsa API,Accept-Languageüstbilgisinde belirtilen tercih edilen dili kullanmaya çalışır. - API, hem kullanıcı hem de yerel halk tarafından okunabilir bir açık adres sağlamak için elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak gerekirse kullanıcının okuyabileceği bir alfabeye çevrilmiş, yerel dildeki açık adresleri döndürür. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü aynı dilde döndürülür. Bu dil, ilk bileşenden seçilir.
- Bir ad tercih edilen dilde kullanılamıyorsa 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 bağlı olarak farklı 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, Macarca'da utca ve tér, sokak kelimesinin eş anlamlılarıdır.
-
konum
Aramanın yapılacağı noktayı
latitude,longitudekoordinatları olarak tanımlar. Yer hizmeti, aramayılocationveradiusile 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 Barcelonagibi açık bir konum içeriyorsalocationparametresi geçersiz kılınabilir. Sorgunun etrafında tırnak işareti kullanmak,locationveradiussembollerine verilen ağırlığı da etkileyebilir. -
telafi etmek
Hizmetin tahminleri eşleştirmek için kullandığı son karakterin giriş terimindeki konumu. Örneğin, giriş
Googleise ve ofset 3 ise hizmetGooile eşleşir. Ofset ile belirlenen dize yalnızca giriş terimindeki ilk kelimeyle eşleştirilir. Örneğin, giriş terimiGoogle abcise ve ofset 3 ise hizmet,Goo abcile eşleşmeye çalışır. Bir kaydırma değeri sağlanmazsa hizmet, terimin tamamını kullanır. Kaydırma genellikle metin imlecinin konumuna ayarlanmalıdır. -
yarıçap
Yer sonuçlarının döndürüleceği mesafeyi (metre cinsinden) tanımlar.
locationveradiusparametrelerini ileterek sonuçları belirli bir daireye göre yönlendirebilirsiniz. Bu işlem, Yerler hizmetine sonuçları bu daire içinde göstermeyi tercih etmesi talimatını verir. Tanımlanan alanın dışındaki sonuçlar yine de gösterilebilir.Yarıçap, arama türüne ve diğer parametrelere bağlı olarak otomatik olarak maksimum değerle sınırlandırılır.
- Otomatik tamamlama: 50.000 metre
-
Yakında Arama:
keywordveyanameile: 50.000 metre-
keywordveyanameolmadan-
Alan yoğunluğuna göre dinamik olarak ayarlanır ve
rankbyparametresinden bağımsız olarak 50.000 metreye kadar. -
rankby=distancekullanılırken yarıçap parametresi kabul edilmez veINVALID_REQUESTile sonuçlanır.
-
Alan yoğunluğuna göre dinamik olarak ayarlanır ve
- Otomatik Sorgu Tamamlama: 50.000 metre
- Metin Arama: 50.000 metre
Otomatik Sorgu Tamamlama (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'Fransızca sonuçlar içeren "Par yakınındaki pizzacılar" isteği:
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.
Otomatik Sorgu Tamamlama (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>
Yer hizmeti, bir aramadan JSON sonuçları döndürdüğünde bunları predictions dizisine yerleştirir. Hizmet sonuç döndürmese bile (örneğin, location uzaktaysa) 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> |
Tahmin dizisi içerir. Daha fazla bilgi için PlaceAutocompletePrediction bölümünü inceleyin. |
|
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 bilgileri içerebilir. Daha fazla bilgi için PlacesAutocompleteStatus bölümüne bakın. |
|
isteğe bağlı | dize |
Hizmet |
|
isteğe bağlı | Array<string> |
Hizmet, istek spesifikasyonu hakkında ek bilgiler döndürdüğünde yanıt nesnesinde ek bir |
PlacesAutocompleteStatus
Hizmet tarafından döndürülen durum kodları.
OK, API isteğinin başarılı olduğunu gösterir.-
ZERO_RESULTS, aramanın başarılı olduğunu ancak sonuç döndürmediğini gösterir. Bu durum, arama uzak bir konumda sınırlara göre yapıldığında ortaya çıkabilir. -
INVALID_REQUEST, API isteğinin hatalı biçimlendirildiğini gösterir. Bu durum genellikleinputparametresinin eksik olmasından kaynaklanır. -
OVER_QUERY_LIMITaşağıdakilerden herhangi birini gösteriyorsa:- Saniyedeki sorgu sınırlarını aştınız.
- Hesabınızda faturalandırma etkinleştirilmemiştir.
- Aylık 200 ABD doları kredi veya kendinizin belirlediği kullanım sınırı aşılmıştır.
- Belirtilen ödeme yöntemi artık geçerli değil (ör. kredi kartının süresi dolmuş).
-
REQUEST_DENIED. Bu e-postada, isteğinizin reddedildiği belirtilir. Bunun nedeni genellikle:- İstek API anahtarı içermiyor.
keyparametresi geçersiz.
UNKNOWN_ERRORbilinmeyen bir hatayı gösterir.
Yer hizmeti, bir aramadan JSON sonuçları döndürdüğünde bunları predictions dizisine yerleştirir. Hizmet sonuç döndürmese bile (ör. location uzaktaysa) 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ılar tarafından okunabilen adını içerir. |
|
required | Array<PlaceAutocompleteMatchedSubstring> |
Girilen terimin tahmin sonucu metnindeki konumunu açıklayan alt dizeler listesi. Böylece, istenirse terim vurgulanabilir. Daha fazla bilgi için PlaceAutocompleteMatchedSubstring bölümüne bakın. |
|
required | PlaceAutocompleteStructuredFormat |
Otomatik tamamlama sonuçlarınızda gösterilebilecek önceden biçimlendirilmiş metinler sağlar. Bu içerik olduğu gibi okunmalıdır. Biçimlendirilmiş adres programatik olarak ayrıştırılmamalıdır. 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 bölümüne bakın. |
|
isteğe bağlı | tam sayı |
Başlangıç noktasından olan düz çizgi mesafesi (metre). Bu alan yalnızca |
|
isteğe bağlı | dize |
Bir yeri benzersiz şekilde tanımlayan metin tanımlayıcısı. 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ışına bakın. |
|
isteğe bağlı | dize |
place_id'yi inceleyin. |
|
isteğe bağlı | Array<string> |
Bu yer için geçerli olan çeşitli türleri içerir. Örneğin:
|
PlaceAutocompleteMatchedSubstring
| Alan | Zorunlu | Tür | Açıklama |
|---|---|---|---|
|
required | sayı |
Tahmin sonucu metninde 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 |
Genellikle yerin adı olan bir tahminin ana metnini içerir. |
|
required | Array<PlaceAutocompleteMatchedSubstring> |
Daha fazla bilgi için PlaceAutocompleteMatchedSubstring bölümüne 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 bölümüne bakın. |
PlaceAutocompleteTerm
| Alan | Zorunlu | Tür | Açıklama |
|---|---|---|---|
|
required | sayı |
Bu terimin açıklamada Unicode karakterleriyle ölçülen başlangıç konumunu tanımlar. |
|
required | dize |
Terimin metni. |