Search For Places
This example request illustrates how to search for places. Using this endpoint you can match (interpret) a place name with a standardized Place Description (in this case, "standard" is the unique identifier of the Place Description). Click here to see a sample app that uses the Place API.
JSON
Request
GET /platform/places/search?q=name:Paris
Accept: application/x-gedcomx-atom+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
Response
HTTP/1.1 200 OK
Content-type: application/x-gedcomx-atom+json
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=86400
Transfer-encoding: chunked{
"results" : 2,
"index" : 0,
"subtitle" : "Results of searching for places.",
"title" : "Place Search Results",
"entries" : [ {
"content" : {
"gedcomx" : {
"places" : [ {
"id" : "7344697",
"lang" : "fr",
"temporalDescription" : {
"formal" : "+1968/"
},
"latitude" : 48.86024,
"longitude" : 2.341109,
"jurisdiction" : {
"resource" : "#442102"
},
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/7344697?flag=fsh"
}
},
"identifiers" : {
"http://gedcomx.org/Persistent" : [ "http://api.familysearch.org/platform/places/5061509" ]
},
"names" : [ {
"value" : "Paris"
} ],
"display" : {
"name" : "Paris",
"fullName" : "Paris, Ville-de-Paris, District of the Paris Region, France",
"type" : "Populated Place"
}
}, {
"id" : "442102",
"lang" : "fr",
"jurisdiction" : {
"resource" : "#204"
},
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/442102?flag=fsh"
}
},
"names" : [ {
"value" : "Ville-de-Paris"
} ]
}, {
"id" : "204",
"lang" : "en",
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/204?flag=fsh"
}
},
"names" : [ {
"value" : "France"
} ]
} ]
}
},
"id" : "7344697",
"score" : 100.0,
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/7344697?flag=fsh"
}
}
}, {
"content" : {
"gedcomx" : {
"places" : [ {
"id" : "3988097",
"lang" : "en",
"latitude" : 42.22722,
"longitude" : -111.40028,
"jurisdiction" : {
"resource" : "#393946"
},
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/3988097?flag=fsh"
}
},
"identifiers" : {
"http://gedcomx.org/Persistent" : [ "http://api.familysearch.org/platform/places/344619" ]
},
"names" : [ {
"value" : "Paris"
} ],
"display" : {
"name" : "Paris",
"fullName" : "Paris, Bear Lake, Idaho, United States",
"type" : "City"
}
}, {
"id" : "393946",
"lang" : "en",
"jurisdiction" : {
"resource" : "#329"
},
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/393946?flag=fsh"
}
},
"names" : [ {
"value" : "Bear Lake"
} ]
}, {
"id" : "329",
"lang" : "en",
"jurisdiction" : {
"resource" : "#1"
},
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/329?flag=fsh"
}
},
"names" : [ {
"value" : "Idaho"
} ]
}, {
"id" : "1",
"lang" : "en",
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/1?flag=fsh"
}
},
"names" : [ {
"value" : "United States"
} ]
} ]
}
},
"id" : "3988097",
"score" : 100.0,
"links" : {
"description" : {
"href" : "https://api.familysearch.org/platform/places/description/3988097?flag=fsh"
}
}
} ]
}
XML
Request
GET /platform/places/search?q=name:Paris
Accept: application/atom+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE
Response
HTTP/1.1 200 OK
Content-type: application/atom+xml
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-transform, must-revalidate, max-age=86400
Transfer-encoding: chunked<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns:fs="http://familysearch.org/v1/" xmlns:gx="http://gedcomx.org/v1/" xmlns="http://www.w3.org/2005/Atom">
<gx:results>2</gx:results>
<gx:index>0</gx:index>
<subtitle>Results of searching for places.</subtitle>
<title>Place Search Results</title>
<entry>
<content type="application/x-gedcomx-v1+xml">
<gx:gedcomx>
<gx:place xml:lang="fr" id="7344697">
<gx:link rel="description" href="https://api.familysearch.org/platform/places/description/7344697?flag=fsh"/>
<gx:identifier type="http://gedcomx.org/Persistent">http://api.familysearch.org/platform/places/5061509</gx:identifier>
<gx:name>Paris</gx:name>
<gx:temporalDescription>
<gx:formal>+1968/</gx:formal>
</gx:temporalDescription>
<gx:latitude>48.86024</gx:latitude>
<gx:longitude>2.341109</gx:longitude>
<gx:jurisdiction resource="#442102"/>
<gx:display>
<gx:fullName>Paris, Ville-de-Paris, District of the Paris Region, France</gx:fullName>
<gx:name>Paris</gx:name>
<gx:type>Populated Place</gx:type>
</gx:display>
</gx:place>
<gx:place xml:lang="fr" id="442102">
<gx:link rel="description" href="https://api.familysearch.org/platform/places/description/442102?flag=fsh"/>
<gx:name>Ville-de-Paris</gx:name>
<gx:jurisdiction resource="#204"/>
</gx:place>
<gx:place xml:lang="en" id="204">
<gx:link rel="description" href="https://api.familysearch.org/platform/places/description/204?flag=fsh"/>
<gx:name>France</gx:name>
</gx:place>
</gx:gedcomx>
</content>
<id>7344697</id>
<link rel="description" href="https://api.familysearch.org/platform/places/description/7344697?flag=fsh"/>
<gx:score>100.0</gx:score>
</entry>
<entry>
<content type="application/x-gedcomx-v1+xml">
<gx:gedcomx>
<gx:place xml:lang="en" id="3988097">
<gx:link rel="description" href="https://api.familysearch.org/platform/places/description/3988097?flag=fsh"/>
<gx:identifier type="http://gedcomx.org/Persistent">http://api.familysearch.org/platform/places/344619</gx:identifier>
<gx:name>Paris</gx:name>
<gx:latitude>42.22722</gx:latitude>
<gx:longitude>-111.40028</gx:longitude>
<gx:jurisdiction resource="#393946"/>
<gx:display>
<gx:fullName>Paris, Bear Lake, Idaho, United States</gx:fullName>
<gx:name>Paris</gx:name>
<gx:type>City</gx:type>
</gx:display>
</gx:place>
<gx:place xml:lang="en" id="393946">
<gx:link rel="description" href="https://api.familysearch.org/platform/places/description/393946?flag=fsh"/>
<gx:name>Bear Lake</gx:name>
<gx:jurisdiction resource="#329"/>
</gx:place>
<gx:place xml:lang="en" id="329">
<gx:link rel="description" href="https://api.familysearch.org/platform/places/description/329?flag=fsh"/>
<gx:name>Idaho</gx:name>
<gx:jurisdiction resource="#1"/>
</gx:place>
<gx:place xml:lang="en" id="1">
<gx:link rel="description" href="https://api.familysearch.org/platform/places/description/1?flag=fsh"/>
<gx:name>United States</gx:name>
</gx:place>
</gx:gedcomx>
</content>
<id>3988097</id>
<link rel="description" href="https://api.familysearch.org/platform/places/description/3988097?flag=fsh"/>
<gx:score>100.0</gx:score>
</entry>
</feed>
Updated 5 days ago