Bu ürün eski durumdadır. Ekim 2026'dan itibaren Places API (Eski) yeni Google Cloud projeleri için etkinleştirilemeyecek. Mevcut projeler tam olarak desteklenmeye devam eder. Yeni özellikler ve daha iyi performans için Places API (Yeni) sürümüne geçin.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Metin Arama (Eski)

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

Not: Sunucu tarafı ve istemci tarafı kitaplıkları

Places API, Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi ile de kullanılabilir. Places API ve istemci kitaplıkları, sunucu uygulamalarında kullanılmak üzere tasarlanmıştır.

İstemci taraflı uygulama geliştiriyorsanız Yerler SDK'sı for Android (Yeni), Yerler SDK'sı for iOS (Yeni) ve Yer Kitaplığı, Maps JavaScript API'ye göz atın.

Text Search (Eski), bir dizeye (ör. "New York'ta pizza", "Ottawa yakınlarındaki ayakkabı mağazaları" veya "123 Main Street") dayalı olarak bir dizi yer hakkında bilgi döndürür. Hizmet, metin dizesiyle ve ayarlanmış konum tercihiyle eşleşen yerlerin listesini döndürür.

Text Search (Eski), aşağıdakiler de dahil olmak üzere belirsiz sorgular için tasarlanmamıştır:

Sorgu türü	Örnek
Tek bir sorguda birden fazla yer, yol veya şehir adı gibi çok fazla kavram ya da kısıtlama	"Market Street San Francisco San Jose Airport"
Google Haritalar'da gösterilmeyen posta adresi öğeleri	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
İşletme, zincir veya kategorilerin, bu varlıkların bulunmadığı konumlarla birleştirilmiş adları	"Dallas, Teksas yakınlarındaki Tesco"
Birden fazla yorumu olan belirsiz sorgular	"Şarj cihazı bırakma"
Artık kullanılmayan eski adlar	"Middlesex Birleşik Krallık"
Coğrafi olmayan öğeler veya niyet	"Ventura Limanı'nda kaç tekne var?"
Resmi olmayan veya özel adlar	"The Jenga" "The Helter Skelter"
Enlem ve boylam koordinatları	"37.422131,-122.084801"

Arama yanıtı, yerlerin listesini içerir. Yanıttaki yerlerden herhangi biri hakkında daha fazla bilgi edinmek için Yer Ayrıntıları isteği gönderebilirsiniz.

Text Search (Legacy) istekleri

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

https://maps.googleapis.com/maps/api/place/textsearch/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.

Arama 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

sorgu

Aranacak metin dizesi (ör. "restoran" veya "123 Main Street"). Bu, bir yer adı, adres veya işletme kategorisi olmalıdır. Diğer giriş türleri hatalara neden olabilir ve geçerli sonuçlar döndüreceği garanti edilmez. Google Places 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.
yarıçap

Yer sonuçlarının döndürüleceği mesafeyi (metre cinsinden) tanımlar. Bir location ve bir radius parametresi ileterek sonuçları belirli bir daireye yönlendirebilirsiniz. Bunu yaptığınızda Places hizmetine, bu daire içindeki sonuçları 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ğere sabitlenir.
- 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, 50.000 metreye kadar.
    - rankby=distance kullanıldığında yarıçap parametresi kabul edilmez ve INVALID_REQUEST ile sonuçlanır.
- Query Autocomplete: 50.000 metre
- Metin Arama: 50.000 metre

İ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 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.
konum

Yer bilgilerinin alınacağı nokta. Bu, latitude,longitude olarak belirtilmelidir.

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.
maxprice

Sonuçları yalnızca belirtilen aralıktaki yerlerle sınırlandırır. Geçerli değerler 0 (en uygun fiyatlı) ile 4 (en pahalı) arasındadır (bu değerler dahil). Belirli bir değerle gösterilen tam miktar bölgeden bölgeye değişir.
minprice

Sonuçları yalnızca belirtilen aralıktaki yerlerle sınırlandırır. Geçerli değerler 0 (en uygun fiyatlı) ile 4 (en pahalı) arasındadır (bu değerler dahil). Belirli bir değerle gösterilen tam miktar bölgeden bölgeye değişir.
opennow

Yalnızca sorgunun gönderildiği sırada açık olan yerleri döndürür. Sorgunuza bu parametreyi dahil ederseniz Google Places veritabanında çalışma saatleri belirtilmeyen yerler döndürülmez.
pagetoken

Daha önce çalıştırılan bir aramadan en fazla 20 sonuç döndürür. pagetoken parametresi ayarlandığında, daha önce kullanılan parametrelerle aynı parametreleri içeren bir arama yürütülür. pagetoken dışındaki tüm parametreler yok sayılır.
bölge

İki karakterli bir ccTLD ("üst düzey alan") değeri olarak belirtilen bölge kodu. Çoğu ccTLD kodu, bazı önemli istisnalar dışında ISO 3166-1 kodlarıyla aynıdır. Ö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).
tür

Sonuçları, belirtilen türle eşleşen yerlerle kısıtlar. Yalnızca bir tür belirtilebilir. Birden fazla tür sağlanırsa ilk girişten sonraki tüm türler yoksayılır.
- type=hospital|pharmacy|doctor, type=hospital olur
- type=hospital,pharmacy,doctor tamamen yoksayılır
Desteklenen türlerin listesine bakın.

Not: Aynı değere (keyword=cafe&type=cafe veya keyword=parking&type=parking) sahip hem keyword hem de type eklemek ZERO_RESULTS ile sonuçlanabilir.

Text Search (Legacy) örnekleri

Not: Bu örneklerde, isteğin uygulamanızda çalışması için key ifadesini kendi API anahtarınızla değiştirmeniz gerekir.

Temel örnek

Aşağıdaki örnekte, Sidney yakınlarındaki restoranlar için yapılan bir arama gösterilmektedir.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

Eksik adres örneği

Aşağıdaki örnekte, eksik bir adres için yapılan arama gösterilmektedir. Bu örnekte, şehir, eyalet veya ülke içermeyen bir açık adres kullanılmıştır.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=123%20main%20street
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Konum yanlılığı örneği

Aşağıdaki örnekte, önceki örnekteki eksik adres için yapılan bir arama gösterilmektedir. Sonuçları ilgilenilen bir bölgeye yönlendirmek için location ve radius parametreleri eklenmiştir.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?location=42.3675294%2C-71.186966
  &query=123%20main%20street
  &radius=10000
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

Text Search (Legacy) yanıtları

Arama yanıtları, URL isteğinin yolundaki output işaretiyle belirtilen biçimde döndürülür.

Aşağıdaki örnekte bir Text Search (Eski) yanıtı gösterilmektedir.

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

Alan	Zorunlu	Tür	Açıklama
`html_attributions`	required	Dizi<string>	Bu girişle ilgili, kullanıcıya gösterilmesi gereken bir dizi ilişkilendirme içerebilir (bazı girişlerde ilişkilendirme olmayabilir).
`results`	required	Dizi<Place>	Bir yer dizisi içerir. Yer Arama istekleri, Yer Ayrıntıları istekleri tarafından döndürülen alanların bir alt kümesini döndürür. İstediğiniz alan Yer Arama tarafından döndürülmüyorsa Yer Arama'yı kullanarak bir `place_id` alabilir, ardından bu yer kimliğini kullanarak Yer Ayrıntıları isteği gönderebilirsiniz. Daha fazla bilgi için Place sayfasına bakın.
`status`	required	PlacesSearchStatus	İ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 PlacesSearchStatus sayfasına bakın.
`error_message`	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.
`info_messages`	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.
`next_page_token`	isteğe bağlı	dize	20 ek sonuç döndürmek için kullanılabilecek bir jeton içerir. Gösterilecek başka sonuç yoksa next_page_token döndürülmez. Döndürülebilecek maksimum sonuç sayısı 60'tır. next_page_token'ın verilmesi ile geçerli hale gelmesi arasında kısa bir gecikme olur.

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.

Alan	Tür	Açıklama
`business_status`	`string`	İşletme ise yerin faaliyet durumunu gösterir: `OPERATIONAL`, `CLOSED_TEMPORARILY` veya `CLOSED_PERMANENTLY`. Durum verisi yoksa atlanır.
`formatted_address`	`string`	Bu yerin okunabilir adresi. Text Search (Legacy) ve Find Place (Legacy) tarafından döndürülür. Biçimlendirilmiş adresi programatik olarak ayrıştırmayın. Bunun yerine Yer Ayrıntıları (Eski) bölümünde `address_components` isteğinde bulunun.
`geometry`	`Geometry`	`lat` ve `lng` koordinatlarına sahip coğrafi kodlu `location` ile `northeast` ve `southwest` sınırlarına sahip tercih edilen `viewport` değerini içerir.
`icon`	`string`	Bu sonucu bir haritada gösterirken kullanabileceğiniz önerilen bir simgenin URL'si.
`icon_background_color`	`string`	Yerin kategorisi için varsayılan onaltılık renk kodu.
`icon_mask_base_uri`	`string`	Önerilen bir simgenin SVG veya PNG dosya türü uzantısı içermeyen ana URL'si.
`name`	`string`	Döndürülen sonucun kullanıcılar tarafından okunabilen adı. `establishment` sonuçları için bu değer genellikle standartlaştırılmış işletme adıdır.
`opening_hours`	`PlaceOpeningHours`	Çalışma saatleri bilgileri. Yer Arama uç noktaları yalnızca `open_now` boole alt alanını döndürür. `periods` ve `weekday_text` için Yer Ayrıntıları (Eski) bölümünde `opening_hours` isteğinde bulunun.
`permanently_closed`	`boolean`	Desteği sonlandırıldı: Bir işletmenin faaliyet durumunu kontrol etmek için `business_status` kullanın.
`photos`	`Array<PlacePhoto>`	Her biri `photo_reference`, `height`, `width` ve `html_attributions` içeren bir `PlacePhoto` nesneleri dizisi. Kullanım ayrıntıları için Place Photos (Eski) başlıklı makaleyi inceleyin.
`place_id`	`string`	Bir yeri benzersiz şekilde tanımlayan metin tabanlı tanımlayıcı. Bu kimliği, Yer Ayrıntıları (Eski) isteğinin `place_id` parametresine iletin. Yer kimliğine genel bakış bölümünü inceleyin.
`plus_code`	`PlusCode`	Enlem ve boylam koordinatlarından türetilen, `global_code` ve isteğe bağlı bir `compound_code` içeren kodlanmış bir konum referansı.
`price_level`	`integer`	Yerin `0` ile `4` arasında, en ucuzdan en pahalıya doğru fiyat seviyesi. `price_level` sayfasına bakın.
`rating`	`number`	Toplu kullanıcı yorumlarına göre yerin `1.0` ile `5.0` arasındaki puanı.
`reference`	`string`	Desteği sonlandırıldı: Bunun yerine `place_id` kullanın.
`scope`	`string`	Desteği sonlandırıldı: `place_id` öğesinin kapsamını belirtir. Bu değer her zaman `GOOGLE` olur. Yakında Arama (Eski) tarafından döndürülür.
`types`	`Array<string>`	Belirli bir sonucu açıklayan özellik türleri dizisi. Yer Türleri (Eski) başlıklı makaleyi inceleyin.
`user_ratings_total`	`integer`	Bu yer için yorum metni içeren veya içermeyen toplam puan sayısı.
`vicinity`	`string`	Yerin sokak adı, sokak numarası ve semtini içeren, eyalet veya il, posta kodu ya da ülke bilgilerini içermeyen basitleştirilmiş adresi. Yakında Arama (Eski) tarafından döndürülür.

Ek sonuçlara erişme

Varsayılan olarak her yanıt, sorgu başına en fazla 20 establishment sonuç döndürür. Ancak her arama, üç sayfaya bölünmüş şekilde 60'a kadar sonuç döndürebilir. Aramanız 20'den fazla sonuç döndürürse arama yanıtı ek bir değer (next_page_token) içerir. Sonraki sonuç grubunu görmek için next_page_token değerini yeni bir isteğin pagetoken parametresine iletin.

next_page_token null ise veya döndürülmezse başka sonuç yoktur.
İsteği aynı next_page_token ile yeniden denediğinizde sonuçların sonraki sayfası döndürülür.
pagetoken ayarı, diğer tüm parametrelerin yoksayılmasına neden olur.
İlk sorgudan sonra en fazla iki kez yeni sayfa isteğinde bulunabilirsiniz.
next_page_token kullanan istekler de dahil olmak üzere her istek, kullanım sınırlarınız açısından tek bir istek olarak sayılır ve ayrı olarak ücretlendirilir.
next_page_token yayınlandıktan sonra geçerli hale gelmesi için birkaç saniye geçmesi gerekir. Sonraki sayfa hazır olmadan önce istekte bulunulursa INVALID_REQUEST yanıtı döndürülür. next_page_token içeren istekler her zaman ücretlendirilir.
Not: next_page_token öğesinin doğru kullanımı, yalnızca kullanıcı tarafından istendiğinde bir sonraki sonuç sayfasını istemektir. Gerçek sayfalama (tek seferde 20 sonuç gösterme) uygulamanızı veya kullanıcı sayfanın sonuna kaydırdığında sonuç sayfasının altına ek yerler eklemenizi öneririz.

Örneğin, aşağıdaki sorguda Sidney, Avustralya'daki Darling Harbour yakınlarındaki restoranları arar ve sonuçları mesafeye göre sıralarız. Yanıtın bir next_page_token özelliği içerdiğini görebilirsiniz.

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

Sonraki sonuç grubunu görmek için next_page_token sonucunu pagetoken parametresine ileterek yeni bir sorgu gönderebilirsiniz. Örneğin:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

Metin Arama (Eski) Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Text Search (Legacy) istekleri

Gerekli parametreler

sorgu

yarıçap

İsteğe bağlı parametreler

language

konum

maxprice

minprice

opennow

pagetoken

bölge

tür

Text Search (Legacy) örnekleri

Temel örnek

curl

HTTP

Eksik adres örneği

curl

HTTP

JSON

XML

Konum yanlılığı örneği

curl

HTTP

JSON

XML

Text Search (Legacy) yanıtları

JSON

XML

PlacesTextSearchResponse

html_attributions

results

status

error_message

info_messages

next_page_token

PlacesSearchStatus

Yer

Ek sonuçlara erişme

Metin Arama (Eski)

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`